跳转至

ISSUE-0113 · offscreen 文档被并发误杀

症状

convertWithTimeout 里失败就重建文档:

if (!result.ok) {
  if (await chrome.offscreen.hasDocument()) await chrome.offscreen.closeDocument();
}

而 offscreen 文档是全局单例,deepScrapeConcurrency 最高 10。于是:

A 超时 → closeDocument()
       → B 的 port 被 Chrome 断开
       → B 立刻拿到 { ok:false, error:'port-disconnected' }
       → B 也进失败分支、也去 closeDocument()
       → C、D… 级联

每个受害者那一页的 markdown 直接丢 —— 这条链路没有重试。 一个慢页面(10 s 转不完)足以打掉同批所有并发转换。

修复:把关文档的条件收窄成两条 AND

  1. 只有 timeout 才关。port-disconnected / connect-failed 恰恰说明文档已经 没了或正被别人关,这时再关一次纯属帮倒忙 —— 下次 ensureOffscreenDocument 会重建。
  2. 只有自己是最后一个在飞的才关(inflightConversions === 1)。

🔴 inflightConversions === 1 的判断到 closingOffscreen 赋值之间不许有 await: 中间让出事件循环的话,新请求会在「已通过检查」和「已挂关闭标志」的空档里溜进来被误杀。 ensureOffscreenDocument 开头补 await closingOffscreen,避免「建了又被关」。

证据(三路变异,md5 逐个证明变异真改到了文件)

变异 结果
去掉 timeout 判据 红 1 条(port-disconnected 那条)
去掉 inflight 保护 红 2 条(连坐 + 调用点在飞数)
两个都去掉(= 修复前原样) 红 3 条 ← 同时证明缺陷在修复前真实存在
还原 3/3 绿,md5 与基线逐字节相同

复核报的另一条:证伪

复核同时点名「链接目标里的 " 脏尾」。实测不成立:

href="https://x.de/a"b"   →  [Ctx](https://x.de/a"b)

" 不是原样留下,而是被 HTML 属性解析器解码成 "(标准行为,不是本项目的解码层做的)。 turndown 的输出忠实反映了源 URL 本身就脏。而属性附录的 TEL_LINK_REGEX_LOCAL = /tel:\s*(\+?[\d\s\-()./]{7,20})/gi 字符类不含 ", 电话提取会在引号前停住,不受污染。⇒ 不改。

🔴 顺带记三个测试基础设施的坑(都在这次踩了,共绕四轮)

写这条回归测试时「connect 一次都没被调用」,我依次误判为 mock 坏了、TDZ、 预热顺序不对,全错。真因和判法:

坑 现象 判法
vi.useFakeTimers() 之下 await import() 不 resolve 动态 import 后的代码一行不执行 对照实测:real timers 下 chrome 调用序列 has→create、connect 命中 1;fake 下两者全 0
纯 microtask 循环推不动 await import() for(...) await Promise.resolve() 之后 port 仍为 0 vitest 的模块运行器要一个 setTimeout tick;flush 必须含宏任务
固定 tick 数在全量跑时 flaky 单跑 3/3 过,全量跑 expected 1 to be 2 改条件轮询 waitFor(() => ports.length === 2),加 tick 数只是把 flaky 推远

⇒ 生产代码留了 timeoutMs 参数默认值注入(同 db-init-guard.ts 的 withDbInitTimeout(run, timeoutMs = DB_INIT_TIMEOUT_MS)),测试走真实 timers 传小值, 不再试图用 fake timers 压缩那 10 s。

证据边界

全部验证在 vitest + mock 的 chrome.offscreen 上完成,没有在真实 Chrome MV3 里 跑过并发转换。mock 里「关文档会断掉所有 port」是照 Chrome 行为模拟的, 这条前提本身未在真机核实。