MongoDB Node.js驱动v4+内置自动重连，无需手动实现；关键在于全局单例复用client、禁用错误close、合理配置keepAlive与minPoolSize，并确保serverSelectionTimeoutMS足够容忍网络抖动。
重连不是手动写的逻辑，而是驱动默认行为
MongoDB Node.js 驱动 v4+ 本身已内置自动重连，你不需要写 setInterval 轮询、也不用封装 connectWithRetry 函数。所谓“断开不重连”，90% 是因为误用了连接实例或配置不当。
常见错误现象包括：MongoServerSelectionError、ServerSelectionTimeoutError、长时间无响应后突然报 ECONNRESET。这些都不是驱动没重连，而是重连上下文被破坏了。
- 每次 HTTP 请求都
new MongoClient()→ 每个实例独立，重连状态无法延续 - 调用了
client.close()→ 主动终结连接池，后续操作必然失败 -
serverSelectionTimeoutMS设太小（如100）→ 网络抖动时直接抛错，根本等不到重连生效 - 监听
error事件后又调client.close()→ 把还在尝试恢复的连接给关了
必须全局单例初始化，且启动时显式 connect
连接对象只能在应用启动时创建一次，并导出复用。任何在路由、服务函数、中间件里新建 MongoClient 的做法，都会导致连接爆炸和重连失效。
正确初始化示例：
const { MongoClient } = require('mongodb');
const client = new MongoClient(process.env.MONGODB_URI, {
serverSelectionTimeoutMS: 5000,
heartbeatFrequencyMS: 5000,
maxPoolSize: 10,
minPoolSize: 1,
keepAlive: 60000,
keepAliveInitialDelay: 300000
});
// 启动时立即连接并验证
async function connectDB() {
try {
await client.connect();
await client.db().command({ ping: 1 }); // 更保险的连通性验证
console.log('✅ MongoDB connected');
} catch (err) {
console.error('❌ MongoDB connection failed:', err);
process.exit(1);
}
}
module.exports = { client, connectDB };
注意：connectDB() 必须被显式调用，且应在 app.listen() 之前完成 —— 否则服务可能已对外暴露，但数据库还没连上。
ECONNRESET 不是代码 bug，而是空闲连接被服务端踢掉
ECONNRESET 多发于空闲几分钟后首次请求，本质是 MongoDB 服务端（尤其是云托管如 Atlas、阿里云）主动 RST 掉了长期空闲的 TCP 连接。这不是客户端问题，但可通过配置缓解。
-
keepAlive: 60000：确保心跳间隔比服务端空闲超时短至少 10 秒（云数据库普遍为 60–300 秒） -
minPoolSize: 1：防止连接池缩容到 0，避免重建连接时触发 RST -
socketTimeoutMS: 0：禁用单次操作超时（它和保活无关，但常被误设过小导致假失败） - Node.js 版本需 ≥ v18.17：旧版存在 libuv 对
SO_KEEPALIVE设置失效的 bug
验证是否生效：用 tcpdump 抓包看是否有周期性 ACK 包；没看到说明配置未起作用或 Node.js 版本太低。
用 Mongoose 时 bufferCommands = false 是硬性要求
如果你用的是 mongoose 而非原生驱动，bufferCommands: false 和 bufferMaxEntries: 0 必须同时设。否则 DB 断连期间所有 save()、find() 等操作会卡在缓冲队列里，看似“没报错”，实则请求永远挂起。
正确写法：
mongoose.set('bufferCommands', false);
mongoose.set('bufferMaxEntries', 0);
await mongoose.connect(uri, {
// 其他选项...
});
这个设置不能漏，也不能只设一个。微服务对响应延迟敏感，缓冲行为会掩盖真实连接状态，让故障排查变得极其困难。
