跳转至

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)

  1. 四处 reject 都被消费,不再产生 unhandled rejection
  2. SW 休眠竞态被识别为可恢复,且留 debug 痕迹
  3. 非竞态的真错误走 warn,不被吞掉 ← 这条防「改成静默吞」
  4. 四个命令都还在,且各自接上同一个分流器(防为了消错误把调用删了)

破坏构造实测:把兜底的 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 才干净。