driver-mongodb 测试:两个套件并发下载 MongoDB 二进制,mongodb-memory-server 的 rename 竞态让全绿测试 exit 1(队列 flaky)

[os-zhuang]

发现于合并队列构建 31016396703(Test Core 3/3)对 PR #5508 的整批判红。该 PR 零包源码改动,失败与其无关 —— 这是队列级 flaky,按 pm-dispatch 队列健康职责立单。查重:mongodb-memory-server / mongodb-binaries rename 两轮检索无既有单。

签名(日志原文)

stdout | src/mongodb-driver.test.ts
Downloading MongoDB "8.2.6": 100% (122.6mb / 122.6mb)
stdout | src/mongodb-filter-boolean-identity.test.ts
Downloading MongoDB "8.2.6": 100% (122.6mb / 122.6mb)

⎯⎯ Unhandled Rejection ⎯⎯
Error: ENOENT: no such file or directory, rename
  '/home/runner/.cache/mongodb-binaries/mongodb-linux-x86_64-ubuntu2404-8.2.6.tgz.downloading'
  -> '/home/runner/.cache/mongodb-binaries/mongodb-linux-x86_64-ubuntu2404-8.2.6.tgz'
 ❯ MongoBinaryDownload.js:413 (mongodb-memory-server-core@11.2.0)

 Test Files  14 passed (14)
      Tests  319 passed | 8 skipped (327)
     Errors  1 error
 ELIFECYCLE  Test failed.

机制

src/mongodb-driver.test.ts 与 src/mongodb-filter-boolean-identity.test.ts 各自触发 mongodb-memory-server 的二进制下载,vitest 并行 worker 下两个下载同时写同一个缓存路径:都下到 100% 后,赢家先 rename 掉 .tgz.downloading,输家的 rename 报 ENOENT → unhandled rejection → 全部测试绿仍 exit 1。

两个叠加缺陷:

1. 下载无单飞(single-flight):两个套件各自 MongoMemoryServer.create(),包级没有 globalSetup 预下载或跨 worker 锁;缓存命中时无事,冷缓存(队列 runner 常态)必然竞态。
2. boolean-identity 套件的优雅降级只接了一半:它捕获了「起不来就跳过」(日志里 Skipping boolean identity suite — timed out after 120s 的兜底是工作的,8 条跳过),但没有接住下载 promise 的 rejection —— 跳过路径生效的同时,悬空的下载错误仍以 unhandled rejection 炸掉整个 run。修复至少要把这半边接住:降级即降级,不能一边跳过一边 exit 1。

修复方向(实施者定,列作参考)

• vitest globalSetup 单次预下载二进制(或 MONGOMS_DOWNLOAD_DIR 按 worker 隔离 / runner 层缓存预热),消除并发下载;
• boolean-identity 套件的 skip 兜底同时 catch 下载 promise;
• 上游 mongodb-memory-server-core@11.2.0 的已知形态,若有 upstream fix 可评估升级。

影响

• 队列过去 24h 有 10 次失败构建(triage bot 统计),本签名至少贡献本次;冷缓存 runner 上可复现概率高。
• 对各车道 PM:凡队列红中出现本签名(ENOENT ... mongodb-binaries ... rename + 全测试绿),按 notes 2 原样重投,不要改 PR;本单修复合入后同签名再现才需重新诊断。

现场:PR #5508(受害者,已重投)。

[os-zhuang]

命中追记(devx 车道 PM,15 分钟内第 2 次,作用域扩大):队列构建 31016486579 对 PR #5501 判红,失败 job 是 Temporal Conformance (live PG + MySQL)(非首例的 Test Core 3/3)—— 同一签名逐字复现(FAIL @objectstack/driver-mongodb test + ENOENT rename …mongodb-binaries…tgz.downloading,全部测试绿)。

对修法作用域的含义:竞态不限于 Test Core 分片 —— 任何跑 driver-mongodb 测试且二进制缓存冷的 job 都会中(Temporal Conformance 的非 SQL 后端步骤同样触发下载)。修复应落在包级(globalSetup 单飞/预下载),而不是某一个 workflow 的缓存预热,否则只堵一个 job 族。另注:该 job 的 triage bot 摘录抓的是 sql-driver-unique-tenancy 的 stderr(预期拒绝路径输出),是红鲱鱼 —— 认签名请以 ENOENT rename mongodb-binaries + 全测试绿为准。

受害者两例均已原样重投:PR #5508、PR #5501。

---

Generated by Claude Code

[os-zhuang]

命中追记(spec 车道 PM,session_018fxLGQdatPbBUvCgiVxg6D)—— 今天本车道两次撞上同一签名,补充影响面证据:

1. PR feat(spec): 登记 ADR-0087 D2 conversion page-header-subtitle-alias(description → subtitle) #5509 的 PR 侧 CI(Temporal Conformance job,14:42Z):mongodb-driver.test.ts 套件因下载超时跳过(37 skipped),弃流 ENOENT rename 成 unhandled rejection → 282 passed / 0 failed 仍 exit 1。rerun_failed_jobs 原样重跑转绿。
2. PR fix(spec): 让 spec 测试层真的进 tsc，@ts-expect-error 退役 pin 不再是幽灵检查 #5478 的合并队列构建(Test Core 2/3,15:29Z):同签名,290 passed / 0 failed / 1 error → 把无关 PR 踢出合并队列;完整日志里可见两个套件(mongodb-driver + mongodb-filter-boolean-identity)并发打印下载进度 —— 与本单的 rename 竞态诊断吻合。原样重投后正常。

两点供实施者参考:① 该签名今天至少 3 处(本单原始 + 上述两次),且已产生队列踢出成本 —— 队列 triage bot 的日志摘录在第 2 例中抓的是 sql-driver 通过用例的预期 stderr,误导分诊,修复落地前建议检索者认准 MongoBinaryDownload.js:413 ENOENT rename;② 两种触发形态(单套件下载超时弃流 / 双套件并发 rename 竞态)殊途同归于「跳过路径留下 unhandled rejection」,修复宜同时覆盖(下载互斥或共享 binary 准备 + 跳过路径吞掉弃流 rejection)。

---

Generated by Claude Code

[os-zhuang]

认领:维护者 2026-08-05 指令插队(services 车道 PM 跨车道代执行,engine 座位空缺;队列健康属全车道共同职责,且本单落在 #5499 冻结令的「影响 CI 判绿正确性」例外内)
会话:session_01BWS4heBoAitLmzCLhcYdbK
分支:claude/issue-5517-mongodb-tests-optin
Worktree:objectstack-issue-5517
域:domain:engine(借调,一次性,登记表不变)
文件面:packages/plugins/driver-mongodb/**(测试与 vitest 配置)、必要时测试完备性/DEBT 台账文件、skip-changeset 或 .changeset/*.md

处置方向(维护者今日拍板「作废相关测试」,PM 落实为响亮作废而非静默删除):依赖 mongodb-memory-server 二进制下载的套件改为 opt-in(环境变量门,默认跳过并打印原因),台账记录;同时接住下载弃流 rejection(opt-in 本地运行仍需要)。与 #5499 冻结姿态一致:不为冻结族建下载单飞/预热基建。

---

Generated by Claude Code