修复Node.js MongoDB驱动版本不兼容：检查package.json版本依赖

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