跳转至

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 扩展管理页的「错误」面板:

Uncaught (in promise) Error: No SW
上下文: background.js
堆叠追踪: background.js:0(匿名函数)

排查:这个字符串不是我们的

搜索域 结果
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]'),判定只消费提取出的字符串。

五层不抛机制:

  1. reportBackgroundError 是同步函数返回 void —— 调用方拿不到 promise,rejection 类型层面无从逃逸
  2. console.error 与 appendSysLog 两个同步调用各自独立 try/catch
  3. appendSysLog 返回的 promise 当场挂 .catch 且不回传 —— 即使 reject 也已是 handled
  4. appendSysLog 本体 writeChain = next.catch(...) —— 一次失败不毒化后续写入
  5. 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 的模块看到了新值。