ISSUE-0218 main.html 的裸 sendMessage 喷 unhandled rejection¶
症状(Tony 截图,v0.16.37)¶
chrome://extensions 错误页反复出现:
Uncaught (in promise) Error: Could not establish connection. Receiving end does not exist.
上下文 main.html
堆叠追踪 main.html:0(匿名函数)
堆栈是 minified bundle 的 :0,没有定位价值 —— 只能从源码侧反查。
根因¶
main.html 这条路径上有 4 处 fire-and-forget 的 sendMessage,
返回的 Promise 无人 catch:
| 文件 | 调用 |
|---|---|
src/auth/context/auth-provider.tsx |
sendMessage({ type: 'close-login' }) |
src/auth/context/auth-provider.tsx |
sendMessage({ type: 'open-login' }) |
src/hooks/use-engine-status.ts |
sendMessage({ type: 'start-engine' }) |
src/hooks/use-engine-status.ts |
sendMessage({ type: 'stop-engine' }) |
这四个 type 在 src/entrypoints/background/ 里都有 listener ——
所以不是「没人接」的常态错误,而是 MV3 SW 休眠竞态:
消息发出时 SW 刚被回收、listener 还没注册完就 reject。
close-login 挂在 auth 轮询(pollingInterval: 2000)的回调路径上,是高频来源。
🔴 仓里本有 src/utils/content-context-guard.ts 吞这类错,
但它覆盖的是 content script,不覆盖 main.html 这条路径。
修法¶
src/utils/ext-context-guard.ts 新增 handleRuntimeMessageError(operation, error),
四处调用各接一个 .catch(...)。调用本身一个没删(删调用是阉割,见 no-mutilation-fix)。
三级分流,不静默吞:
扩展上下文失效 → trigger()(既有自动刷新行为)
handleContextError 能认的 → 交给它
SW 休眠竞态 → console.debug,留痕但不打扰
其它 → console.warn ← 响亮,不当没发生
最后一级是重点:.catch(() => {}) 会让「background 真挂了」永远查不出来,
而 scan:error-handling 的 silent_catch 规则本来就拦这个形态。
判据(tests/runtime-message-rejection-guard.test.ts)¶
- 四处 reject 都被消费,不再产生 unhandled rejection
- SW 休眠竞态被识别为可恢复,且留 debug 痕迹
- 非竞态的真错误走 warn,不被吞掉 ← 这条防「改成静默吞」
- 四个命令都还在,且各自接上同一个分流器(防为了消错误把调用删了)
破坏构造实测:把兜底的 console.warn 换成注释 ⇒ 判据 3 红(1 failed / 3 passed);
还原后 4/4 绿。
🔴 过程教训:这一刀是被中途掐断的¶
执行方(sol-dsh)在跑到一半时被主控 kill(起因是主控未经 Tony 同意连派三刀)。
kill 时它已写完四处收口和四条判据,但 pnpm compile 还红着:
测试文件里 globalThis.chrome 用了 typeof chrome,
而本仓测试跑 node 环境、没有 @types/chrome 全局声明 ⇒ TS2304 + TS7017。
⇒ 「测试全绿」不等于「可以提交」。定向测试 4/4 通过的同时 compile 是红的 —— 两个闸量的不是同一件事,缺一个就会把半截状态当成完成态。 主控补修了那 3 处类型引用(改用局部别名承接,不依赖不存在的全局类型), compile 才干净。