正式支持与验证矩阵

当前矩阵以 公开验证链真正跑过的组合 为准;未实证的版本不写进正式支持范围。
其中 Node.js 需要区分两层:公共 CI 基线 与 默认 server matrix。

公共 CI 基线

维度当前范围证据
Node.js18.x / 20.x / 22.x.github/workflows/test.yml + npm test(smoke + compatibility + unit + integration)+ npm run verify:fast
ModuleCJS / ESMtest/smoke/root-cjs.test.ts / root-esm.test.ts 编译后的测试产物

默认 server matrix

维度正式支持证据
Node.js20.x / 22.xtest/compatibility/matrix.json + npm run test:server-matrix
MongoDB Driver6.x / 7.xnpm run test:server-matrix
MongoDB Server7.x / 8.xmongodb-memory-server 7.0.37 / 8.0.26 single + replica set 严格矩阵

GridFS 是 <bucket>.files 与 <bucket>.chunks 上的客户端约定。它的集成测试跑在 mongodb-memory-server 7.0.37 上。这不会把 MongoDB 4.x,或 7.x / 8.x 以外的服务器,写进本矩阵。

默认验证方式

  • Default gate:npm test
  • Fast:npm run verify:fast
  • Full functional gate:npm run verify:full
  • Coverage governance:npm run test:coverage(独立命令,也是 release-preflight 强制阶段)
  • Matrix:npm run test:server-matrix
  • 打包自检:npm run release:preflight
  • Private real env:npm run test:real-env:private

公开验证与私有验证边界

  • verify:fast / verify:full / test:server-matrix / release:preflight 都属于公开可复现验证命令;test:coverage 是独立覆盖率验证命令。
  • npm test 现在默认覆盖 smoke / compatibility / unit / integration;已迁移的 TypeScript 测试先编译到 .generated/test-dist/test/** 再执行,不再保留独立迁移 runner。
  • test:real-env:private 与 verify:release 属于显式 opt-in 的私有真实环境验证,需要操作者自行注入 SSH / Mongo 环境变量。
  • GitHub Actions 默认只运行公开检查,不假设任何私有 SSH / Mongo 资源存在。
  • probe:server-matrix 和 test:server-matrix 对必需版本、拓扑、Driver 或测试组合不提供 skip 降级;unavailable/failed 都会以非零退出阻断发布。

暂不纳入正式支持

项目当前状态
Node 18.x server matrix已进入公共 CI 基线,但未纳入当前 Driver / Server 正式矩阵
MongoDB Driver 4.x / 5.x仅保留历史兼容参考,未纳入当前正式矩阵
MongoDB Server 6.x已 EOL,仅保留历史验证记录和特性最低版本说明,不进入 v3 发布矩阵
legacy lib/** compat 子路径仅保留迁移期显式回归,不纳入默认门禁与正式支持矩阵
非 MongoDB 数据库路线图阶段,当前不支持