MongoDB Ubuntu配置常见问题及解决

以下是Ubuntu下配置MongoDB的常见问题及解决方法：

1. 服务无法启动

• 原因：配置文件错误、权限不足、端口占用或磁盘空间不够。
• 解决：
  • 检查配置文件 /etc/mongod.conf 中的 dbPath、logPath 是否正确，确保目录存在且权限正确（sudo chown -R mongodb:mongodb /var/lib/mongodb）。
  • 查看服务状态：sudo systemctl status mongod，若未启动，尝试 sudo systemctl start mongod。
  • 检查端口占用：sudo netstat -tulnp | grep 27017，若被占用需修改配置文件中的 port 或停止占用进程。

2. 连接被拒绝

• 原因：服务未运行、防火墙拦截、bindIp 配置错误或认证未启用。
• 解决：
  • 确保服务运行：sudo systemctl start mongod。
  • 开放防火墙端口：sudo ufw allow 27017。
  • 修改配置文件中 net.bindIp 为 0.0.0.0（允许远程访问，生产环境建议限制为内网IP）。
  • 若启用认证，需使用正确用户名密码连接：mongo -u admin -p password --authenticationDatabase admin。

3. 权限问题

• 原因：数据目录或日志文件权限不足，导致MongoDB无法读写。
• 解决：
  • 确保数据目录（如 /var/lib/mongodb）和日志目录权限正确：
    sudo chown -R mongodb:mongodb /var/lib/mongodb
sudo chmod -R 0755 /var/lib/mongodb。

4. 配置文件语法错误

• 原因：配置文件格式错误（如缩进、参数拼写错误）。
• 解决：
  • 使用命令检查配置文件语法：mongod --config /etc/mongod.conf --fork，根据报错信息修正。

5. 磁盘空间不足

• 原因：数据目录所在磁盘空间不足，导致服务无法启动或运行异常。
• 解决：
  • 检查磁盘空间：df -h，清理不必要的文件或扩展磁盘。
  • 修改数据目录到空间充足的路径（需在配置文件中更新 dbPath）。

6. 远程访问失败

• 原因：防火墙未开放端口、bindIp 未设置为 0.0.0.0 或未启用认证。
• 解决：
  • 开放防火墙：sudo ufw allow 27017。
  • 修改配置文件：bindIp: 0.0.0.0，并重启服务。
  • 若启用认证，需确保远程用户拥有对应权限。

7. 日志报错（如 “Failed to create lock file”）

• 原因：数据目录权限不足或服务异常退出。
• 解决：
  • 删除锁文件：sudo rm /var/lib/mongodb/mongod.lock。
  • 修复数据：sudo mongod --repair，然后重启服务。

参考来源：