如何修复MongoDB MongooseServerSelectionError连接超时错误

运行在Ubuntu VPS Docker容器内的MongoDB，与同服务器部署的Node.js应用建立连接时抛出MongooseServerSelectionError: connection timed out报错，报错指向目标服务地址为147.60.221.79:27017，可按以下步骤逐一排查修复：

• 校验MongoDB容器运行状态
  在VPS终端执行docker ps，确认承载MongoDB的容器状态为Up，无异常退出记录。如果容器未正常运行，执行docker logs 你的Mongo容器名查看启动日志，优先排查磁盘空间不足、目录权限错误、配置文件格式错误这类常见启动失败问题，修复后重启容器再测试连接。
• 检查容器端口映射规则
  执行docker port 你的Mongo容器名查看端口映射配置：

  如果Node.js应用同样部署在该VPS的Docker容器内，优先使用Docker内部网络互联，直接以Mongo容器名作为连接host即可，不需要把Mongo端口映射到宿主机，性能更好且避免端口暴露风险。
  如果走宿主机公网/回环IP连接，需要确认输出存在0.0.0.0:27017->27017/tcp的映射规则；如果映射规则绑定的是127.0.0.1:27017，外部网络/其他容器无法访问，需要在启动Mongo容器时追加-p 27017:27017参数重新创建容器，或调整端口绑定配置。

• 校验网络访问控制规则
  走公网IP连接时，需要确认两层规则放通27017端口的TCP访问：
  1. 云服务商VPS控制台的安全组入站规则，放通对应来源IP的27017端口访问（如果仅本机应用使用，不要配置0.0.0.0/0全量放通，避免被攻击）
  2. Ubuntu系统本地防火墙，执行ufw status查看规则列表，如果未放通27017端口，执行ufw allow 27017/tcp添加放通规则。

  安全提示：未开启账号鉴权的MongoDB绝对不要对公网暴露端口，极易被勒索病毒扫描入侵。

• 检查MongoDB监听配置
  进入Mongo容器查看mongod.conf配置文件中的bindIp参数：如果需要通过宿主机/外部网络访问，需要将参数调整为bindIp: 0.0.0.0，调整后重启容器生效；如果仅走Docker内部网络互联，不需要修改该配置。
• 校验Mongoose连接串配置
  检查Node.js项目中配置的Mongoose连接串格式是否正确，标准带鉴权的连接串格式为：

  mongodb://[用户名]:[密码]@[host]:27017/[数据库名]?authSource=admin&connectTimeoutMS=30000
  

  常见配置错误包括：开启鉴权后未填写账号密码、未指定authSource=admin（MongoDB默认账号存储在admin库下）、密码包含特殊字符未做URL转义、连接超时时间设置过短，可追加connectTimeoutMS=30000将超时时间调整为30秒，排除网络延迟导致的偶发超时。
• 连通性逐跳验证
  先在VPS宿主机执行nc -zv 147.60.221.79 27017测试端口连通性，如果连接失败回到前面步骤排查端口映射、防火墙、监听配置问题；如果宿主机能连通，再进入Node.js应用的运行环境（如果应用是容器部署就进对应容器）执行同样的nc命令测试，容器内无法连通的话，将两个容器加入同一个自定义Docker桥接网络即可解决。

• 同VPS部署的应用和数据库不要走公网IP连接，创建自定义Docker网络将两个容器加入同一网络，直接用Mongo容器名作为连接host，不需要映射端口到宿主机，延迟更低、安全性更高。
• MongoDB必须开启账号密码鉴权，禁止无密码访问。
• 不要使用Docker默认的bridge网络，自定义网络自带内置DNS解析，支持直接通过容器名互访，不需要手动维护容器内部IP。

内容的提问来源于stack exchange，提问作者Kavishka