不能只监听connect事件，因该事件仅表示TCP连接建立，无法反映副本集切换、网络中断、凭据过期或mongos路由异常等真实故障；必须执行db.runCommand({ping:1})验证实际命令执行能力。
直接暴露 MongoClient 的连接状态不够可靠，健康检查必须触发一次真实数据库操作才能确认服务可用性。
为什么不能只监听 connect 事件
Node.js 连接 MongoDB 后，connect 事件只表示驱动成功建立 TCP 连接并完成初始握手。但以下情况仍会导致后续请求失败：
- Atlas 集群节点临时不可达（如副本集主节点切换中）
- 网络策略变更导致连接被静默中断（例如云服务商的空闲连接超时）
- 认证凭据过期或权限被回收（尤其在使用短期 token 或 IAM 角色时）
-
mongos路由层异常，而驱动未感知
因此，仅靠事件监听会给出“假阳性”结果。
用 db.runCommand({ ping: 1 }) 做最小开销探测
这是 MongoDB 官方推荐的轻量级连通性验证方式，不涉及集合、索引或数据，也不受读写权限限制。
- 必须在已连接的
db实例上调用，不能在MongoClient上直接调用 - 返回
{ ok: 1 }表示当前连接可执行命令，即“健康” - 超时应设为 2–3 秒，避免拖慢整个健康端点响应
- 不要复用业务连接池做探测——它可能正被高负载阻塞；建议单独配置一个低并发、短超时的专用 client
示例代码片段：
const { MongoClient } = require('mongodb');
const healthClient = new MongoClient(process.env.MONGODB_URI, {
maxPoolSize: 1,
minPoolSize: 0,
serverSelectionTimeoutMS: 2000,
socketTimeoutMS: 2000
});
async function checkMongoHealth() {
try {
await healthClient.connect();
const db = healthClient.db();
await db.runCommand({ ping: 1 });
return { status: 'up', timestamp: new Date().toISOString() };
} catch (err) {
return { status: 'down', error: err.message };
} finally {
await healthClient.close(); // 每次检查后关闭，避免连接堆积
}
}
如何避免健康接口拖垮数据库
高频轮询（如 Kubernetes 默认每 10 秒探活）会对 MongoDB 造成无意义压力，尤其在分片集群中会广播到所有 mongos。
- 把健康检查频率交给调用方控制，服务端不做轮询逻辑
- 不要在
/health中嵌套多个数据库依赖的检查（比如同时查 Redis + Mongo）——应拆分为/health/db和/health/cache - 禁止在健康检查里执行
findOne()或聚合查询：它们可能命中慢查询、触发磁盘扫描或锁表 - 如果使用 Mongoose，别调用
mongoose.connection.readyState——它只是内存状态，不是实时链路验证
生产环境必须加的两个参数
不设置这两个选项，健康检查在 Atlas 或分片集群上大概率误报：
-
serverSelectionTimeoutMS: 3000：默认是 30 秒，K8s 探针等不及就会标记为失败 -
directConnection: true（仅适用于单节点或明确知道拓扑的场景）：绕过 SRV 记录解析和 replica set 发现，减少 DNS 和心跳延迟；但在 Atlas 必须设为false（默认），否则无法自动发现副本集成员
容易被忽略的是：Atlas 连接字符串里的 ?retryWrites=true&w=majority 是写安全保证，与健康检查无关，但若删掉，ping 命令仍能成功——所以不能靠删参数来“简化”连接。
