正式支持与验证矩阵

当前矩阵以 公开验证链真正跑过的组合 为准;未实证的版本不写进正式支持范围。
其中 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 严格矩阵

默认验证方式

  • Default gatenpm test
  • Fastnpm run verify:fast
  • Full functional gatenpm run verify:full
  • Coverage governancenpm run test:coverage(独立命令,也是 release-preflight 强制阶段)
  • Matrixnpm run test:server-matrix
  • 打包自检npm run release:preflight
  • Private real envnpm 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:privateverify:release 属于显式 opt-in 的私有真实环境验证,需要操作者自行注入 SSH / Mongo 环境变量。
  • GitHub Actions 默认只运行公开检查,不假设任何私有 SSH / Mongo 资源存在。
  • probe:server-matrixtest: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 数据库路线图阶段,当前不支持