不匹配的驱动版本会导致连接静默失败、connect()报错或MongoClient构造失败；必须按MongoDB Server版本与Node.js版本双向对齐驱动版本，例如Server 7.0 + Node.js v20需用mongodb@6.x或@7.1。
直接结论：不匹配的驱动版本会导致连接静默失败、connect() 报错或 MongoClient 构造失败，必须按 MongoDB Server 版本 + Node.js 运行时版本双向对齐驱动版本。
查清当前环境真实版本组合
别只看 package.json 里写的版本——实际安装的可能被锁死、被缓存覆盖或存在 peer 依赖冲突。先确认三端真实状态：
- 运行
mongod --version查 MongoDB Server 版本（如6.0.15或7.0.12） - 运行
node -v查 Node.js 版本（如v18.17.0或v20.12.0） - 运行
npm list mongodb查当前项目安装的驱动版本（注意是否显示extraneous或deduped）
这三个值缺一不可。例如：MongoDB Server 7.0 + Node.js v20 → 驱动必须用 mongodb@6.x 或 @7.1；若强行装 mongodb@4.17，client.connect() 会抛 TypeError: Cannot read properties of undefined 或直接跳过执行。
修正 package.json 中的 mongodb 版本字段
package.json 的 dependencies 里写错版本号是常见源头。v7 驱动要求 Node.js ≥ v18.13，且不再兼容 MongoDB Server
- 若 Server 是 6.0–6.3 且 Node.js 是 v18.x：改用
"mongodb": "^6.7.0"（稳定兼容区间） - 若 Server 是 7.0+ 且 Node.js ≥ v18.13：升级到
"mongodb": "^7.1.0"（注意：v7.0 起强制要求@aws-sdk/credential-providers等新 peer 依赖） - 若 Node.js 是 v16 或更老：只能用
"mongodb": "^4.17.0"（v4 最后支持 v14/v16），但需确认 Server ≤ 6.0
改完后务必删掉 package-lock.json 和 node_modules，再跑 npm install。残留的 lock 文件常导致 npm 忽略新版本声明。
检查并补全 peerDependencies（尤其 v7+）
v7 驱动把多个底层依赖升为显式 peer 依赖，漏装会导致 require 失败或认证流程中断。运行 npm install 后，检查控制台是否输出 peer dep missing 警告。关键 peer 项包括：
bson@7.0.0mongodb-connection-string-url@7.0.0-
@mongodb-js/kerberos@7.0.0（Windows/Linux Kerberos 认证必需） -
@aws-sdk/credential-providers（启用MONGODB-AWS认证时强制需要）
如果用到了 AWS IAM 认证，但没装 @aws-sdk/credential-providers，连接字符串里即使写了 ?authMechanism=MONGODB-AWS，也会在 await client.connect() 时静默拒绝，错误信息只显示 Authentication failed，不提示缺包。
验证连接代码是否适配目标驱动版本
版本不兼容最典型的“症状”不是报错，而是代码根本不执行到 console.log('Connected')。这是因为 v4+ 彻底移除了回调风格，且 useUnifiedTopology 已默认启用：
- ❌ 错误写法（v3 风格，v4+ 会静默跳过）：
MongoClient.connect(url, callback) - ✅ 正确写法（v4+ 强制 async/await 或 Promise）：
const client = new MongoClient(url); await client.connect(); - v7 还新增了
changeStream配置透传，但若旧代码硬传resumeAfter到watch()第二个参数，会报Unknown option—— 必须改用{ resumeAfter: ... }作为 options 对象传入
真正容易被忽略的是：**驱动版本降级后，旧版连接选项（如 sslValidate）可能已被移除，但代码里还留着，导致 connect() 拒绝初始化而不报具体字段错误。** 建议每次换版本后，重读对应版本的 官方连接选项文档，逐项核对。
