怎样在Linux上解决MongoDB连接问题

Linux上排查与修复 MongoDB 连接问题的实用步骤

一 快速自检

• 确认服务是否在运行：sudo systemctl status mongod；若未运行：sudo systemctl start mongod。
• 本地直连测试：mongo --host 127.0.0.1 --port 27017（或 mongosh）。
• 远程连通性测试：ping <服务器IP>；telnet 27017 或 nc -vz 27017。
• 查看服务日志定位错误：tail -n 100 /var/log/mongodb/mongod.log。
  以上步骤能快速判断是服务未启动、网络不通还是配置问题。

二 配置与权限核查

• 配置文件 /etc/mongod.conf：
  • net.bindIp：默认 127.0.0.1 仅本地；远程访问需改为 0.0.0.0（或指定内网网段/具体IP）。
  • net.port：默认 27017。
  • 修改后重启：sudo systemctl restart mongod。
• 启用认证时：security.authorization 设为 enabled；连接串需包含用户名、密码与鉴权库（常见为 admin），例如：mongo --host --port 27017 -u -p --authenticationDatabase admin。
• 连接字符串格式：mongodb://:@:/?authSource=。
• 云数据库场景：需在控制台正确设置白名单并使用对应私网/公网地址；账号密码含特殊字符（如 !@#$%^&*()_+=）需转义；副本集建议使用ConnectionStringURI以自动适配主从切换。

三 网络与防火墙

• 放行端口：
  • Ubuntu：sudo ufw allow 27017/tcp
  • CentOS：sudo firewall-cmd --add-port=27017/tcp --permanent && sudo firewall-cmd --reload
  • 或放行 iptables：sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT
• 云上实例：除本机防火墙外，还需在云厂商控制台放通客户端 IP/网段 到实例的白名单。
• 端口占用：lsof -i :27017 或 netstat -tulpen | grep 27017，必要时结束占用进程后重启 mongod。

四 常见报错与对应处理

• 服务未启动或端口被占用：检查状态与日志；若日志出现 “Address already in use”，释放 27017 或调整端口后重启。
• 连接被拒绝/超时：核对 bindIp 是否为 0.0.0.0（或正确网段）、端口是否一致、云实例白名单是否包含客户端 IP。
• 认证失败：确认用户名/密码正确，且连接串中 authSource 指向账号所在数据库（常见为 admin）。
• serverSelectionTimeout：常见于网络不通、地址/端口错误、白名单/安全组阻断、或实例负载/连接数满；逐项核查网络、地址、鉴权与实例负载。
• 副本集写入失败：单节点地址在主备切换后可能指向 Secondary；改用ConnectionStringURI或在故障恢复后重连。

五 一键排查清单与修复命令示例

• 服务与端口：
  • sudo systemctl status mongod；sudo systemctl restart mongod
  • ss -lntp | grep 27017 或 lsof -iUDP:27017
• 配置与权限：
  • grep -E ‘bindIp|port|authorization’ /etc/mongod.conf
  • 启用认证示例：security.authorization: enabled；连接示例：mongo --host -u -p --authenticationDatabase admin
• 防火墙与连通性：
  • Ubuntu：sudo ufw allow 27017/tcp；CentOS：sudo firewall-cmd --add-port=27017/tcp --permanent && sudo firewall-cmd --reload
  • ping ；nc -vz 27017
• 日志与数据目录：
  • tail -f /var/log/mongodb/mongod.log
  • ls -ld /var/lib/mongodb /var/log/mongodb；必要时 chown -R mongodb:mongodb /var/lib/mongodb
• 云数据库：核对白名单、私网/公网地址、账号密码特殊字符转义、使用ConnectionStringURI。