MongoDB在Ubuntu上的故障排除

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

sudo systemctl status mongod

若服务未运行，会显示“inactive (dead)”或“failed”状态，需进一步排查启动失败原因。

日志是故障定位的核心，MongoDB的默认日志路径为/var/log/mongodb/mongod.log。使用以下命令查看最新错误信息（按F/E过滤关键级别）：

sudo tail -n 100 /var/log/mongodb/mongod.log  # 查看最后100行
sudo grep -E 'E|F' /var/log/mongodb/mongod.log | tail -n 20  # 过滤错误/致命日志

日志中的FATAL（致命）或ERROR（错误）条目会明确提示故障原因（如配置错误、权限问题、数据损坏）。

MongoDB的主配置文件为/etc/mongod.conf，常见配置错误包括：

端口冲突：确认net.port（默认27017）未被其他进程占用；
绑定地址错误：若需远程访问，需将net.bindIp从127.0.0.1修改为0.0.0.0（允许所有IP）或具体IP；
路径错误：确认storage.dbPath（数据目录）、systemLog.path（日志目录）存在且路径正确。
修改配置文件后，需重启服务使变更生效：

sudo systemctl restart mongod

MongoDB服务通常以mongodb用户（或mongod，取决于安装方式）运行，需确保数据目录、日志目录及套接字文件的权限正确：

数据目录权限（默认/var/lib/mongodb）：

sudo chown -R mongodb:mongodb /var/lib/mongodb  # 归属mongodb用户/组
sudo chmod -R 755 /var/lib/mongodb              # 设置合理权限

套接字文件权限（默认/tmp/mongodb-27017.sock）：

sudo chown mongodb:mongodb /tmp/mongodb-27017.sock  # 归属mongodb用户/组
sudo chmod 600 /tmp/mongodb-27017.sock              # 仅所有者可读写

权限问题常表现为“Permission denied”或“Failed to create lock file”。

检查端口占用：使用以下命令确认27017端口是否被MongoDB监听：
```
sudo netstat -tulnp | grep 27017  # 或使用 ss -tulnp | grep 27017
```
若端口被其他进程占用，需停止该进程或修改MongoDB的net.port配置。

配置防火墙：若使用ufw防火墙，需允许MongoDB端口：

sudo ufw allow 27017/tcp  # 允许TCP协议的27017端口
sudo ufw reload           # 重新加载防火墙规则

若日志提示“WiredTiger error”（存储引擎故障）或“Data corruption”（数据损坏），需修复数据文件：

备份数据（若有重要数据，务必先备份）：
```
sudo cp -r /var/lib/mongodb /var/lib/mongodb_backup
```
修复命令：以修复模式启动MongoDB，自动修复数据文件：
```
sudo mongod --config /etc/mongod.conf --repair
```
重启服务：修复完成后重启MongoDB：
```
sudo systemctl restart mongod
```

注意：修复过程可能导致部分数据丢失，建议定期备份。

本地连接失败：检查服务状态、配置文件及权限；
远程连接失败：除上述步骤外，还需确认：
- mongod.conf中的bindIp已设置为0.0.0.0；
- 防火墙允许27017端口；
- 网络可达（使用ping <服务器IP>测试）。
  使用mongo命令测试连接：

mongo --host <服务器IP> --port 27017  # 如 mongo --host 192.168.1.100 --port 27017

若MongoDB因资源不足无法启动，需检查以下指标：

通过以上步骤，可覆盖Ubuntu上MongoDB的常见故障场景。若问题仍未解决，建议根据日志中的具体错误信息查阅MongoDB官方文档或社区论坛（如Stack Overflow）。

最新问答