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¶
- 只有
timeout才关。port-disconnected/connect-failed恰恰说明文档已经 没了或正被别人关,这时再关一次纯属帮倒忙 —— 下次ensureOffscreenDocument会重建。 - 只有自己是最后一个在飞的才关(
inflightConversions === 1)。
🔴 inflightConversions === 1 的判断到 closingOffscreen 赋值之间不许有 await:
中间让出事件循环的话,新请求会在「已通过检查」和「已挂关闭标志」的空档里溜进来被误杀。
ensureOffscreenDocument 开头补 await closingOffscreen,避免「建了又被关」。
证据(三路变异,md5 逐个证明变异真改到了文件)¶
| 变异 | 结果 |
|---|---|
去掉 timeout 判据 |
红 1 条(port-disconnected 那条) |
去掉 inflight 保护 |
红 2 条(连坐 + 调用点在飞数) |
| 两个都去掉(= 修复前原样) | 红 3 条 ← 同时证明缺陷在修复前真实存在 |
| 还原 | 3/3 绿,md5 与基线逐字节相同 |
复核报的另一条:证伪¶
复核同时点名「链接目标里的 " 脏尾」。实测不成立:
" 不是原样留下,而是被 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 行为模拟的,
这条前提本身未在真机核实。