本地Docker部署的MongoDB连接超时？求问题排查指引

1. 检查本地27017端口是否被占用 #

容器日志显示MongoDB在内部正常监听27017，但如果本地该端口已被其他MongoDB实例或进程占用，Docker的端口映射会失效，外部请求根本到不了容器。

检查方法：

• Windows：命令提示符执行 netstat -ano | findstr :27017
• macOS/Linux：终端执行 lsof -i :27017 或 netstat -tulpn | grep 27017

若发现占用，要么停止对应进程，要么修改docker-compose的端口映射（比如改成 - 27018:27017），重启容器后用新端口连接：mongodb://root:rootpassword@localhost:27018。

2. 验证容器内服务是否正常 #

先确认容器内的MongoDB本身能正常访问，排除服务启动异常：

docker exec -it meteodb mongosh -u root -p rootpassword

如果能成功进入MongoDB Shell，说明容器内服务没问题，问题出在外部到容器的网络通路，可尝试重启Docker服务后再连接。

3. 排查防火墙/安全软件拦截 #

本地防火墙、杀毒软件可能会拦截27017端口的入站请求。临时关闭防火墙做测试，若连接成功，就给27017端口添加防火墙允许规则。

4. 特殊环境下的localhost适配 #

• 若用WSL2运行Docker：localhost无法直接映射到容器，需换成WSL2虚拟机IP。在WSL终端执行 hostname -I 获取IP，连接字符串改为 mongodb://root:rootpassword@<WSL_IP>:27017。
• 若部署在远程服务器：不要用localhost，换成服务器公网/内网IP，同时确保服务器安全组开放27017端口。

5. 确认容器运行状态 #

先检查容器是否正常运行：

docker ps

若容器未启动，查看启动日志定位问题：

docker logs meteodb

另外，日志里显示监听0.0.0.0是正常配置，代表MongoDB在容器内所有网络接口监听，这不是问题所在。

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