title: Chrome 错误面板出现无栈的「Error: No SW」—— 全仓搜不到这个字符串 description: SW 未捕获 rejection 既不可定位也不留痕;补 13 类裸 promise 的 catch + 记 sysLog tags: [service-worker, 错误处理, 可观测性, MV3, 用户反馈] created: 2026-09-03 updated: 2026-09-03 type: issue status: fixed severity: medium fixed_version: 0.10.165 related: - "0143-three-layer-lock-deadlock" - "0142-scrape-observability"
ISSUE-0144 · SW 未捕获 rejection 不可定位¶
起因¶
Tony 截图 Chrome 扩展管理页的「错误」面板:
排查:这个字符串不是我们的¶
| 搜索域 | 结果 |
|---|---|
src/ 全树 |
0 |
dist-v2/chrome-mv3/(manifest 确认 0.10.164,就是用户装的那版) |
0 |
node_modules/.pnpm/ 整个依赖树 |
0 |
backup/ 全部历史构建 |
0 |
git log --all -S "No SW" 全历史 |
0 |
⇒ 这个字符串从来没在本仓出现过,是 Chrome 浏览器自己抛的。
background.js:0(匿名函数) + 没有真实栈,是异步 rejection 丢掉调用上下文的典型形态。
🔴 本 issue 不回答「Chrome 在什么条件下抛 No SW」——没查出来,标 UNVERIFIABLE。 派工时明确写了「主控不知道,也不要求你猜」,避免执行方编一个听起来合理的原因。
真正的问题:不可定位¶
改动前 background/index.ts 的两个 guard:
- 良性错误(
Failed to fetch/NetworkError/AbortError/Load failed/Extension context invalidated) →console.warn+preventDefault - 其余(含
No SW)→ 什么都不做:不 preventDefault(会上面板)、不留任何持久化记录
⇒ 用户关掉错误面板,信息就灭失了。我们既不知道它从哪个调用来,也没有任何数据。
修法¶
1. 未知 rejection 记 sysLog,且不抑制¶
🔴 No SW 没有加进良性列表 —— 抑制显示等于掩盖。未知错误既记日志、又继续上面板。
2. 补 13 类裸 promise 的 catch¶
执行方通读 index.ts 全文 499 行 + 对每个候选 grep 函数签名(声明为同步的再读函数体确认不返回 promise),
查到 13 类(主控给的候选只有 6 个):
manageQueue ×4 · syncAlarmState ×3 · syncWatchdogAlarm ×3 · browser.tabs.remove ×2 ·
browser.tabs.create ×2 · openWindow('login') · closeWindow('login') · appendPageLog ·
storage.setItem ×4(headerListener 内)· browser.alarms.create ×2 · 等
补完后,如果 No SW 来自其中之一,它会带着我们自己的 callsite 出现在系统日志里。
订正:主控把 enqueuePaging 列为裸 promise 候选,实测它是同步函数。
3. 错误处理器自己不能制造错误¶
审查方发现:guard 在调 extractErrorInfo 之前先自己读了 e?.reason?.message。
如果 reason 是 message getter 会抛的对象(Proxy / defineProperty throwing getter),
guard 在读它的那一刻就抛了 —— 原错误没记录,还多了个新的同步错误。
修法:两个监听器本体抽进 rejection-guard.ts,一切对 reason 的属性读取先走 extractErrorInfo
(内部对 .message/.name/.stack 各自 try/catch、String() 再兜一层、最外层 catch
返回 '[extractErrorInfo failed]'),判定只消费提取出的字符串。
五层不抛机制:
reportBackgroundError是同步函数返回 void —— 调用方拿不到 promise,rejection 类型层面无从逃逸console.error与appendSysLog两个同步调用各自独立 try/catchappendSysLog返回的 promise 当场挂.catch且不回传 —— 即使 reject 也已是 handledappendSysLog本体writeChain = next.catch(...)—— 一次失败不毒化后续写入extractErrorInfo对带 throwing getter 的异物 reason 全程 try/catch
测试覆盖:throwing getter / 循环引用 / get 陷阱全抛的 Proxy / 异物 event 本体
(preventDefault 抛)—— 均要求 guard 不抛且仍然记下一条日志。
4. batch-controller.ts 五处裸调走 catchAndLog¶
订正:审查方说的 pumpPagerOnly 这个函数名仓里不存在(主控照抄了没核)。
实际是 manageQueue@storePageOneData / pumpPager@enqueuePaging /
manageQueue@runPagingJob / appendPageLog@runPagingJob / manageQueue@doResumeFromInterception。
🔴 只加错误处理,不改控制流:pumpPager 抛错时 do-while 本来就中止,
catchAndLog 不改这个语义;manageQueue 与 appendPageLog 本来就是 fire-and-forget,
补 catch 后翻页照走、错误留痕。
副产品:一个此前在验空气的测试¶
执行方排障时实测发现:测试文件原有的 memStore = {} 重置对 vi.mock 工厂闭包不可靠
(beforeEach 清空后 getSysLogs 仍读到旧条目,id 跨用例泄漏)。
⇒ 同机制下,该文件里「storage 抛异常」用例的 storageDown 开关此前大概率根本没到 mock。
修法:共享状态改 vi.hoisted 持有,日志断言一律用「动作前后 id 差集」。
教训:mock 的重置方式本身也需要验证。清空了一个变量不等于被 mock 的模块看到了新值。