在Ubuntu上如何进行MongoDB故障排查

Ubuntu上MongoDB故障排查指南

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

关键过滤技巧：

提取错误/致命日志（优先处理）：
```
grep -E 'E|F' /var/log/mongodb/mongod.log
```

查找特定时间段日志（如过去1小时）：

grep -E 'E|F' /var/log/mongodb/mongod.log | awk '$1 > "2025-10-31T14:00"'

日志中的组件标识（如NETWORK、STORAGE、REPL）可快速定位问题模块（如网络连接、存储引擎、副本集同步）。

3. 验证配置文件正确性

MongoDB配置文件路径为/etc/mongod.conf，常见需检查的配置项：

绑定地址：net.bindIp（默认127.0.0.1仅本地访问，远程访问需改为0.0.0.0或具体IP）；
端口：net.port（默认27017，确保未被其他进程占用）；
数据目录：storage.dbPath（如/var/lib/mongodb，需存在且有正确权限）；
日志路径：systemLog.path（如/var/log/mongodb/mongod.log，需可写入）。
修改配置文件后，重启服务使变更生效：

sudo systemctl restart mongod

可使用以下命令快速检查配置文件语法：

mongod --config /etc/mongod.conf --eval

若语法错误，命令会返回具体提示。

4. 检查数据目录与权限

MongoDB需要对其数据目录（storage.dbPath指定的路径）有读写权限。常见错误为“Permission denied”或“Failed to create lock file”。

确认数据目录存在（若不存在则创建）：
```
sudo mkdir -p /var/lib/mongodb
```
修改目录所有者为mongodb用户（MongoDB默认运行用户）：
```
sudo chown -R mongodb:mongodb /var/lib/mongodb
```
设置合理权限（避免过度开放，推荐0755）：
```
sudo chmod -R 0755 /var/lib/mongodb
```

权限问题是最常见的启动故障之一，需重点排查。

5. 排查端口占用问题

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

sudo netstat -tulnp | grep 27017

或使用更现代的ss命令：

sudo ss -tulnp | grep 27017

若发现占用进程，可选择：

停止占用进程（sudo kill -9 <PID>）；
修改MongoDB配置文件中的net.port为其他端口（如27018）。
修改后需重启服务。

6. 处理常见连接问题

若出现“Connection refused”（连接被拒绝）或“无法连接到服务器”错误，需检查以下内容：

服务是否运行：通过systemctl status mongod确认；
配置文件bindIp：确保允许远程访问（如0.0.0.0）；
防火墙设置：允许MongoDB端口通过（Ubuntu默认使用ufw）：
```
sudo ufw allow 27017
```
连接字符串是否正确：使用mongo命令测试连接（本地默认）：
```
mongo --host 127.0.0.1 --port 27017
```

远程连接需替换为服务器IP地址。

7. 修复数据文件损坏

若MongoDB无法启动并提示“Corrupted data files”或“WiredTiger error”，需修复数据文件：

删除锁文件（谨慎操作，确保无其他实例运行）：
```
sudo rm /var/lib/mongodb/mongod.lock
```

以修复模式启动MongoDB：

sudo mongod --repair --dbpath /var/lib/mongodb

重启服务：
```
sudo systemctl start mongod
```

修复前建议备份数据文件（/var/lib/mongodb），避免数据丢失。

8. 利用日志分析工具

对于复杂故障，可使用工具提升日志分析效率：

基础过滤：使用grep、awk提取关键信息（如上述“查看日志”部分）；
JSON解析：使用jq工具解析JSON格式日志（需安装：sudo apt install jq）：
```
sudo cat /var/log/mongodb/mongod.log | jq '.msg'
```
日志轮转：配置logrotate自动管理日志文件（避免日志过大占用磁盘），编辑/etc/logrotate.d/mongodb：
```
/var/log/mongodb/mongod.log {
  daily
  rotate 7
  compress
  missingok
  notifempty
  sharedscripts
  postrotate
    /bin/kill -SIGUSR1 $(cat /var/lib/mongodb/mongod.lock 2>/dev/null) 2>/dev/null || true
  endscript
}
```
此配置表示每天轮转日志，保留7天，压缩旧日志，并在轮转后通知MongoDB重新打开日志文件。

通过以上步骤，可覆盖Ubuntu上MongoDB的常见故障场景。若问题仍未解决，建议查阅MongoDB官方文档或社区论坛（如Stack Overflow），提供具体日志信息以获取进一步帮助。