MongoDB Ubuntu故障排查步骤

MongoDB Ubuntu故障排查通用步骤

1. 检查MongoDB服务状态

首先确认MongoDB服务是否正在运行，使用以下命令查看服务状态：

sudo systemctl status mongod

若服务未运行（显示“inactive”或“failed”），尝试启动服务：

sudo systemctl start mongod

若需设置开机自启，执行：

sudo systemctl enable mongod

此步骤可快速判断服务是否处于可用状态，是故障排查的第一步。

2. 查看MongoDB日志文件

日志文件包含详细的错误信息，是定位问题的核心依据。MongoDB默认日志路径为/var/log/mongodb/mongod.log，使用以下命令实时查看最新日志：

sudo tail -f /var/log/mongodb/mongod.log

重点关注日志中的“ERROR”“FAILED”等关键词，如“Permission denied”“Port already in use”等，可直接指向问题根源。

3. 验证配置文件正确性

MongoDB的主配置文件通常位于/etc/mongod.conf，需检查以下关键配置项的正确性：

• storage.dbPath：数据存储目录是否存在（如/var/lib/mongodb），若不存在则创建：

  sudo mkdir -p /var/lib/mongodb
  

• systemLog.path：日志文件路径是否有写入权限。
• net.bindIp：绑定的IP地址是否正确（本地测试可设为127.0.0.1，远程访问需设为0.0.0.0）。
• net.port：端口是否被占用（默认27017）。
  修改配置文件后，需重启服务使变更生效：

sudo systemctl restart mongod

配置文件语法错误或路径不正确是常见的启动失败原因。

4. 检查数据目录权限

MongoDB进程需要对数据目录（如/var/lib/mongodb）具有读写权限。默认情况下，MongoDB用户为mongodb，使用以下命令修正权限：

sudo chown -R mongodb:mongodb /var/lib/mongodb
sudo chmod -R 0755 /var/lib/mongodb

权限不足会导致“Permission denied”“Cannot open file”等错误，需确保目录归属和权限正确。

5. 排查端口占用问题

MongoDB默认使用27017端口，若该端口被其他进程占用，服务将无法启动。使用以下命令检查端口占用情况：

sudo netstat -tulnp | grep 27017

若发现占用进程（如PID: 1234），可选择停止该进程（sudo kill -9 1234）或修改MongoDB配置文件中的net.port为其他端口（如27018），然后重启服务。

6. 测试网络连接（远程访问场景）

若需远程连接MongoDB，需确保以下配置正确：

• 配置文件：/etc/mongod.conf中net.bindIp设置为0.0.0.0（允许所有IP访问）或指定远程IP。
• 防火墙：允许27017端口通过（Ubuntu默认使用ufw防火墙）：

  sudo ufw allow 27017
  

• 连接测试：从远程机器使用mongo命令测试连接：

  mongo --host <服务器IP> --port 27017
  

若仍无法连接，需检查服务器网络配置（如云服务商的安全组规则）。

7. 检查系统资源使用情况

MongoDB对内存和磁盘空间要求较高，资源不足会导致服务崩溃或性能下降。使用以下命令检查资源使用情况：

• 内存：free -h（查看可用内存，若剩余内存不足，需增加服务器内存或优化MongoDB缓存配置）。
• 磁盘空间：df -h（查看根分区或数据目录所在分区的剩余空间，若剩余空间小于10%，需清理无用文件）。
• 磁盘I/O：iostat -x 1（查看磁盘读写负载，若I/O等待过高，需升级磁盘或优化查询）。

8. 修复数据目录（启动失败场景）

若MongoDB因数据目录损坏无法启动，可使用--repair参数修复：

sudo mongod --config /etc/mongod.conf --repair

修复完成后，重启服务即可。注意：修复前建议备份数据目录，避免数据丢失。

9. 查阅官方文档与社区资源

若以上步骤无法解决问题，需查阅MongoDB官方文档（如Ubuntu安装与配置指南）或在社区论坛（如Stack Overflow、MongoDB Community）搜索类似问题的解决方案。提供详细的错误日志和系统环境信息（如MongoDB版本、Ubuntu版本），有助于快速定位问题。