ECONNREFUSED表示连不上服务端，server selection timeout表示驱动找不到可用节点，ECONNRESET表示连接曾建立但被主动重置；三者分别对应服务未启/网络拦截、DNS或IP白名单问题、TCP保活失效或中间设备断连。
超时不是代码写错了，而是连接链路在某个环节被卡住或主动切断。 直接改 socketTimeoutMS 或重试次数基本没用，得先分清是“连不上”“选不到节点”还是“连上了但被踢了”——三类问题对应完全不同的配置和排查路径。
怎么区分 ECONNREFUSED、server selection timeout 和 ECONNRESET？
错误信息里直接暴露了根本原因：
-
MongoServerSelectionError: connect ECONNREFUSED→ 连不上服务端，可能是 MongoDB 没启动、IP/端口错、防火墙拦了出站连接 -
MongoTimeoutError: Server selection timed out after XXX ms→ 驱动在规定时间内没找到可用节点，常见于 Atlas IP 白名单没开、DNS 解析失败、mongodb+srv://串没生效 -
connect ECONNRESET→ 连接曾成功建立，但空闲后被服务端或中间设备（如负载均衡、云厂商网关）RST 断开，典型表现是应用跑几分钟后突然报错
Atlas 连不上？先查 Network Access 和 DNS
本地 mongosh 能连、Node.js 连不上，90% 是 Atlas 的网络准入问题：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 打开 Atlas 控制台 → Network Access → 添加当前公网 IP（用
curl ifconfig.me获取），别填localhost或内网地址 - 连接字符串必须以
mongodb+srv://开头，否则无法解析 SRV 记录；如果 DNS 不稳，可临时加?tls=false测试（仅调试） - 企业/校园网常拦截 TLS 出站连接，Windows/macOS 防火墙可能静默丢包，需手动放行
node.exe或允许*.mongodb.net
连接成功后频繁 ECONNRESET？调 keepAlive 和连接池
这不是客户端没心跳，而是心跳间隔比服务端空闲超时还长，或者服务端根本不响应 TCP keepalive 包：
- 设
keepAlive: 60000（60 秒），比 Atlas 默认 60–300 秒超时至少短 10 秒 - 加
keepAliveInitialDelay: 300000（5 分钟），避免刚连上就发心跳 - 必须配
minPoolSize: 1，防止连接池缩容到 0 后重建连接 -
socketTimeoutMS要设为0（禁用）或足够大（如300000），它和保活无关，只控制单次读写等待上限
慢查询会把连接池堵死，别只盯着超时参数
连接池满载（MongoWaitQueueFullException）往往不是池子太小，而是某条查询卡住不释放：
- 开启 profiling：
db.setProfilingLevel(1, { slowms: 100 })，查db.system.profile.find({ millis: {$gt: 100} }) - 重点看
planSummary：如果是COLLSCAN，说明缺索引；docsExamined远大于nReturned，说明扫描低效 - 对慢查询执行
.explain("executionStats")，关注totalDocsExamined和totalKeysExamined差距，差距过大说明索引没走对
真正麻烦的从来不是参数本身，而是你配了 keepAlive，服务端却根本不回 ACK；或是你调大了 serverSelectionTimeoutMS，DNS 却一直解析失败——这些细节不验证，光改配置等于没改。
