MongoDB运行报错：无法连接127.0.0.1:27017，请求排查解决

针对你遇到的连接失败报错：

W NETWORK [thread1] Failed to connect to 127.0.0.1:27017 after 5000ms milliseconds, giving up.
E QUERY [thread1] Error: couldn't connect to server 127.0.0.1:27017, connection attempt failed

可以按以下步骤排查解决：

• 检查MongoDB服务状态

  • Windows：打开服务管理器，找到MongoDB服务，确认状态为“正在运行”，未启动则右键启动；也可在管理员命令行执行 net start MongoDB。
  • Linux/macOS：执行 systemctl status mongod 查看状态，未启动则用 systemctl start mongod 启动，需要开机自启加 systemctl enable mongod。

• 确认端口27017是否被占用

  • Windows：命令行执行 netstat -ano | findstr :27017，记录结果中的PID，打开任务管理器结束对应非MongoDB进程。
  • Linux/macOS：用 lsof -i :27017 或 netstat -tulpn | grep :27017 找到占用进程，执行 kill -9 <PID> 终止（替换为实际进程ID）。

• 验证MongoDB配置文件

  • 找到mongod.conf配置文件（Windows通常在安装目录bin下，Linux多在/etc/mongod.conf）：
    1. 确认net.bindIp设置为127.0.0.1或0.0.0.0（允许所有IP连接），避免因绑定其他IP导致本地无法访问。
    2. 确认net.port为27017，修改配置后需重启MongoDB服务。

• 尝试指定主机端口连接

  • 旧版本执行 mongo --host 127.0.0.1 --port 27017，新版MongoDB用 mongosh --host 127.0.0.1 --port 27017，测试是否能正常连接。

• 检查防火墙规则

  • Windows：确认防火墙未阻止27017端口，可临时关闭防火墙测试是否恢复连接。
  • Linux：若使用ufw防火墙，执行 ufw allow 27017 开放端口；若用iptables，需添加允许27017端口的规则。

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