不匹配的驱动版本看似小事，一旦踩坑就会导致连接静默失败——代码看似正常运行，却始终连不上数据库；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 6.0 以下版本。分几种情况处理：
- 若 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() 拒绝初始化而不报具体字段错误。建议每次换版本后，重读对应版本的官方连接选项文档，逐项核对一遍，省得踩暗坑。
