atlas连接超时主因是ip白名单未放行当前出口ip、本地/企业防火墙拦截tls出站连接、连接字符串未用mongodb+srv://协议或dns解析失败、超时参数过短；需逐一排查network access设置、防火墙规则、驱动版本、dns配置及超时选项。
Atlas连接超时：先确认IP白名单是否放行当前出口IP
Node.js 连接 MongoDB Atlas 超时，90% 以上不是代码问题，而是网络准入被拦。Atlas 默认拒绝所有外部 IP，必须手动添加允许访问的 IP 地址（或 IP 段）到项目 → Network Access 列表中。
常见错误现象：MongoTimeoutError: Server selection timed out after 30000 ms，但本地 mongosh 或 Compass 能连上；或者日志里只显示“connecting...”后无响应。
- 打开 Atlas 控制台 → 左侧菜单选 Network Access → 点 + ADD IP ADDRESS
- 开发阶段最省事：填
0.0.0.0/0（允许所有 IPv4），但仅限测试，切勿用于生产 - 更安全的做法：在终端运行
curl ifconfig.me获取你当前公网出口 IP，填入并加 /32（如203.0.113.42/32） - 如果你用公司网络或校园网，IP 可能动态变化，建议配合动态 DNS 或定期更新；使用云服务器部署时，填该服务器的公网 IP
本地防火墙或代理会拦截出站 27017（或 TLS 端口）连接
Atlas 不走默认的 27017 端口，而是强制使用 TLS 加密的 SRV 记录 + 随机端口（通常是 27017 或 27015–27018 范围），但很多企业防火墙、Windows Defender 防火墙、甚至 macOS 的“防火墙选项”会默认阻止未知出站连接。
错误表现：Node.js 进程卡在 client.connect()，不报错也不超时，几秒后才抛出 MongoServerSelectionError 或 getaddrinfo ENOTFOUND。
- Windows 用户：进「Windows 安全中心」→「防火墙和网络保护」→「允许应用通过防火墙」→ 找到你的 Node.js（
node.exe）并勾选「专用」和「公用」网络 - macOS 用户：系统设置 → 隐私与安全性 → 防火墙 → 防火墙选项 → 确保
node在允许列表中；若启用了「阻止所有传入连接」，需临时关闭测试 - 公司/学校网络：联系 IT 部门确认是否屏蔽了 MongoDB Atlas 的域名（如
*.mongodb.net、*.mongodb.com）或 TLS SNI 指向的证书链
连接字符串里漏了 +srv 或没启用 DNS 解析
Atlas 提供的连接字符串分两类：mongodb://（旧版，已弃用）和 mongodb+srv://（强制要求）。后者依赖 DNS SRV 和 TXT 记录自动发现节点地址与 TLS 设置——如果 Node.js 环境 DNS 解析异常，就会卡住或超时。
典型错误：MongoParseError: Invalid scheme, expected connection string to start with "mongodb://" 或静默失败。
- 务必从 Atlas 的「Database Connect」→「Connect your application」页面复制完整字符串，它形如：
mongodb+srv://user:pass@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority - 确保安装的驱动版本 ≥ v4.0（
npm install mongodb@latest），v3.x 不支持+srv协议 - 某些内网 DNS（如企业 DNS 服务器）会过滤 SRV 查询，可临时改用公共 DNS 测试：在终端执行
nslookup -type=SRV _mongodb._tcp.cluster0.xxxxx.mongodb.net，看是否返回记录
超时参数没调，而 Atlas 初始连接本就慢
Atlas 免费层（M0）或低配集群首次建立连接可能耗时 5–10 秒，尤其跨大洲区域（比如你在杭州连美国东部集群）。若没显式设超时，serverSelectionTimeoutMS 默认是 30 秒，看似够用，但实际在 DNS 解析失败或 TLS 握手卡顿时，会提前触发失败。
关键点：这个超时值控制的是“选节点”的等待时间，不是整个连接过程，且它不包含 DNS 查询耗时。
- 在
new MongoClient()的 options 中显式加大：serverSelectionTimeoutMS: 10000（10 秒） - 同时加
connectTimeoutMS: 10000控制 TCP 连接建立上限 - 禁用
useUnifiedTopology: false（不要关！v4+ 已默认 true，关了反而更容易超时） - 避免在
.env里写死连接串却忘记 URL 编码密码——含/、@、:的密码必须用encodeURIComponent()处理后再拼接
client.db('xxx') 时拼错了名，不会报错，后续操作才失败——这种“连上了却读不到数据”的假象，常被误判为连接超时。
