mongotimeouterror和mongoserverselectionerror多因连接链路中断而非代码错误，需区分econnrefused（连不上）、server selection timeout（选不到节点）、econnreset（空闲被踢）三类场景，并针对性配置超时参数、keepalive、ip白名单及dns解析。
MongoTimeoutError 和 MongoServerSelectionError 这类超时错误，90% 不是代码写错了，而是连接链路在某个环节被卡住或主动切断。关键要分清是“连不上”（ECONNREFUSED）、“连得上但选不到可用节点”（server selection timeout），还是“连上了但空闲后被踢”（ECONNRESET）——每种对应完全不同的修复路径。
确认是 server selection timeout 还是 socket timeout
错误信息里带 Server selection timed out after XXX ms，说明驱动在规定时间内没找到可用的 MongoDB 节点；如果报的是 connect ETIMEDOUT 或长时间卡在 connecting 状态，更可能是网络层阻断。
-
serverSelectionTimeoutMS控制“找节点”的总耗时，默认 30000ms，必须显式设小（如5000）来快速失败，避免挂起 -
socketTimeoutMS是单次读/写操作等待响应的上限，默认 30000ms，它和连接保活无关，但若设得太小（比如 1000），简单查询都可能超时 - 云数据库（如 Atlas、阿里云）强制关闭空闲连接，此时
socketTimeoutMS设再大也没用，得靠keepAlive+minPoolSize
Atlas 或云 MongoDB 必须检查 IP 白名单和 DNS
本地 mongosh 能连、Node.js 连不上，大概率是 Atlas 的 Network Access 没放行你的出口 IP，或者 DNS 解析失败。
- 打开 Atlas 控制台 → Network Access → 添加你当前公网 IP（用
curl ifconfig.me获取），别填localhost或内网地址 - 连接字符串必须用
mongodb+srv://开头，否则无法解析 SRV 记录；如果 DNS 不稳定，可临时加?tls=false测试（仅限调试） - 企业/校园网常拦截 TLS 出站连接，Windows 防火墙、macOS 防火墙、甚至代理软件会静默丢包，需手动放行
node.exe或允许*.mongodb.net
本地 MongoDB 连不上 localhost:27017？先看服务和绑定地址
MongoServerSelectionError: connect ECONNREFUSED ::1:27017 表示 Node.js 尝试用 IPv6（::1）连，但 mongod 只监听了 IPv4（127.0.0.1）。
- 运行
sudo systemctl status mongod（Linux/macOS）或sc query MongoDB（Windows）确认服务真在运行 - 检查
/etc/mongod.conf中bindIp是否为127.0.0.1或0.0.0.0，别留空或写成::1 - 连接 URL 改成
mongodb://127.0.0.1:27017/，比localhost更可靠；必要时加family: 4强制 IPv4：new MongoClient(uri, { family: 4 })
连接成功后仍超时？重点调 keepAlive 和连接池
应用跑几分钟后突然报 ECONNRESET，说明连接被服务端或中间设备 RST 掉了，不是客户端问题。
-
keepAlive: 60000（60 秒心跳间隔），必须比云厂商空闲超时短至少 10 秒（Atlas 默认 60 秒，阿里云也是 60 秒） -
keepAliveInitialDelay: 300000（5 分钟后才发第一个心跳），避免刚连上就发包 -
minPoolSize: 1防止连接池缩容到 0，否则下次请求得重建连接，容易撞上服务端超时 -
socketTimeoutMS: 0或300000（禁用或设大），否则单次操作中途超时会中断连接，和保活无关
真正麻烦的从来不是参数怎么填，而是云厂商根本透传不了 TCP keepalive 包——这时候只能去翻他们文档确认是否支持，或者换用连接串里加 maxIdleTimeMS 主动回收连接。
