跳转至

[ISSUE-0178] 旧 content script 的临终噪音

现象

Tony 2026-09-19 截图,chrome://extensions 错误面板:

Uncaught (in promise) Error: Extension context invalidated.
上下文  https://www.google.com/maps/search/water%20sports%20equipment%20rental%20service,+Parker,+ID
堆叠追踪  content-scripts/content.js:165(匿名函数)

成因

扩展一 reload(开发期刷新、或商店自动更新),旧的 content script 仍然活在已经打开的页面上, 但它持有的 chrome API 句柄已经作废。它下一次碰 storage / sendMessage 就抛这个错。

⚠️ 这不是「扩展坏了」,但它看起来就是 —— 用户打开错误面板只看到一串红。

为什么不能复用 ext-context-guard

那一套(ISSUE-0022 / 0052)的收尾动作是 location.reload(): 对扩展自己的页面(main / popup / settings)是对的,重载就拿到新 context。

但 content script 跑在用户的 Google Maps 页面上 —— reload 会把用户正在看的地图、正在跑的搜索结果一起刷掉。那是破坏性的。

修法

新建 src/utils/content-context-guard.ts,只做两件事:

  1. unhandledrejection 里识别 context 失效家族,preventDefault() 不让它冒成 uncaught
  2. console.debug 留一条能看懂的痕

WXT 的 ctx 本来就会在 invalidate 时自动卸载我们注入的 UI —— 按钮消失本身就是「该刷新这一页了」的信号,不需要额外打扰用户。

两个约束,方向相反、缺一不可

① 判定必须窄。 只认三种措辞(Extension context invalidated / Receiving end does not exist / message port closed)。 放宽成「所有 chrome 相关错误」会把真 bug 一起吞掉 —— 而被吞掉的真 bug 是查不出来的,比噪音危险得多。

② 留痕只能用 debug。 chrome://extensions 的错误面板收集 warn 和 error。 用那两级留痕 = 一边消音一边制造同样的噪音。 🔄 v0.14.3 在 focus-guard 上踩过一模一样的坑:守卫「修好了」, 但留痕用 warn,于是用户在错误面板里照样看到一片红。

必须 import-time 自启

挂在 src/entrypoints/content/index.tsx 的第一行。 ISSUE-0052 的教训:等到 main(ctx) 里才装 listener, import 阶段(injectScript / RequestInterceptors / storage 初始化) 产生的 rejection 就漏在 listener 之前,照样冒进错误面板。

判据

tests/content-context-guard.test.ts 6 条(3 条变异全部被抓): 认得出三种措辞 + 字符串形态的 reason;误吞检测(8 个无关错误一个都不许认); 不许 reload;不许用 warn/error 留痕;必须顶层自启且是入口第一个 import。