如何解决Ubuntu MongoDB连接失败

Ubuntu 上 MongoDB 连接失败的排查与修复指南

一 快速自检

• 确认服务是否在运行：执行 sudo systemctl status mongod（或旧包用 sudo service mongod status）。若未运行，执行 sudo systemctl start mongod 并观察状态。
• 查看服务日志定位根因：执行 sudo journalctl -xeu mongod 或直接查看 /var/log/mongodb/mongod.log。
• 本机连通性测试：执行 mongosh --host 127.0.0.1:27017（旧客户端为 mongo）。若仅本机可连、远程失败，多为 bindIp 或云安全组限制。
• 端口占用检查：执行 sudo ss -ltnp | grep 27017，若被占用需释放或调整端口。
• 资源与权限：执行 df -h 检查磁盘；确认数据目录（如 /var/lib/mongodb）属主为 mongodb:mongodb，必要时修正：sudo chown -R mongodb:mongodb /var/lib/mongodb。
  以上步骤覆盖了服务状态、日志、端口、资源和权限四个关键维度，可快速判断问题方向。

二 常见原因与对应修复

• 服务未启动或异常退出
  1. 查看日志定位错误（如配置、权限、磁盘、端口冲突）。
  2. 端口冲突：释放占用或改端口后重启服务。
  3. 磁盘满：清理或扩容后重启。
  4. 修复后启动：sudo systemctl restart mongod 并复核状态与日志。
• 异常关机导致数据不一致
  1. 停止服务：sudo systemctl stop mongod。
  2. 删除锁文件：sudo rm /var/lib/mongodb/mongod.lock。
  3. 以修复模式启动：sudo -u mongodb mongod -f /etc/mongod.conf --repair。
  4. 正常启动：sudo systemctl start mongod。
• 绑定地址或端口限制
  1. 仅本机访问：在 /etc/mongod.conf 的 net 段设置 bindIp: 127.0.0.1；如需局域网访问，可改为 bindIp: 127.0.0.1,<内网IP>。
  2. 云服务器需放行安全组/防火墙的 27017 端口。
  3. 重启服务后再次测试连接。
• 认证与客户端版本不匹配
  1. 若启用认证，连接需指定 -u/-p 与 –authenticationDatabase。
  2. 出现 “Auth mechanism not specified” 等错误，多为客户端过旧，升级到与服务器相近的大版本（如 4.0.x）。
• 文件权限错误
  1. 数据目录与日志目录属主应为 mongodb：sudo chown -R mongodb:mongodb /var/lib/mongodb /var/log/mongodb。
  2. 配置文件若不可写，使用 sudo 编辑或调整属主后再改。
     以上修复覆盖了最常见的启动失败、异常关机一致性、网络绑定、认证与权限问题。

三 连接字符串与客户端示例

• 本机无认证：
  • 命令：mongosh “mongodb://127.0.0.1:27017”
• 启用认证（示例库为 admin）：
  • 命令：mongosh “mongodb://:@127.0.0.1:27017/admin?authSource=admin”
• 远程连接（将 <server_ip> 替换为实际内网/公网 IP）：
  • 命令：mongosh “mongodb://:@<server_ip>:27017/admin?authSource=admin”
    说明：旧版工具为 mongo，新版为 mongosh；URI 中 authSource 指定存放用户凭据的数据库（常见为 admin）。

四 配置文件与最小可用示例

• 建议路径与关键项：
  • 配置文件：/etc/mongod.conf
  • 数据目录：/var/lib/mongodb（属主 mongodb:mongodb）
  • 日志目录：/var/log/mongodb（属主 mongodb:mongodb）
• 最小可用配置示例（按需增删）：
  • storage:
    • dbPath: /var/lib/mongodb
  • systemLog:
    • destination: file
    • path: /var/log/mongodb/mongod.log
    • logAppend: true
  • net:
    • port: 27017
    • bindIp: 127.0.0.1（如需远程，改为 127.0.0.1,<内网IP>）
  • security:
    • authorization: enabled（启用后连接需提供凭据）
      修改后执行：sudo systemctl restart mongod 并用日志与连接测试验证。