Debian MongoDB故障排查有哪些常见步骤

Debian系统下MongoDB故障排查常见步骤

1. 检查MongoDB服务状态

使用systemctl或service命令确认MongoDB服务是否正在运行，若未运行则尝试启动服务。

sudo systemctl status mongod  # Debian 9+推荐使用systemd
# 或
sudo service mongod status    # 旧版本Debian可能使用sysvinit

若服务未启动，可通过sudo systemctl start mongod启动，并通过sudo systemctl enable mongod设置开机自启。

2. 查看MongoDB日志文件

MongoDB日志是故障排查的核心线索，通常位于/var/log/mongodb/mongod.log（部分旧版本可能在/usr/local/mongodb/logs/）。使用以下命令实时查看最新日志或搜索关键词（如ERROR、FATAL）：

sudo tail -f /var/log/mongodb/mongod.log          # 实时查看最新日志
sudo grep "ERROR" /var/log/mongodb/mongod.log     # 筛选错误信息

日志中会明确提示服务启动失败、权限不足、端口冲突等具体原因。

3. 确认MongoDB配置文件正确性

MongoDB的主配置文件通常为/etc/mongod.conf（部分手动安装可能在/usr/local/mongodb/bin/mongodb.conf），需检查以下关键配置项：

storage.dbPath：数据存储目录是否存在（如/var/lib/mongodb）；
systemLog.path：日志文件路径是否正确且有写入权限；
net.bindIp：绑定的IP地址（127.0.0.1仅本地访问，0.0.0.0允许远程访问，需根据需求调整）；
net.port：端口是否被占用（默认27017）。
可使用以下命令快速检查配置文件语法：

mongod --config /etc/mongod.conf --eval  # 无报错则表示语法正确

4. 检查数据目录与权限

MongoDB需要对数据目录（storage.dbPath指定的路径）有读写权限，否则会导致服务无法启动。常见操作如下：

sudo mkdir -p /var/lib/mongodb                # 若目录不存在则创建
sudo chown -R mongodb:mongodb /var/lib/mongodb  # 修改所有者为mongodb用户
sudo chmod -R 755 /var/lib/mongodb            # 设置合理权限（避免777）

注意：部分旧版本可能使用/usr/local/mongodb/data/db作为数据目录，需根据实际配置调整。

5. 检查端口占用与防火墙设置

MongoDB默认使用27017端口，若该端口被其他进程占用或防火墙阻止，会导致连接失败。

检查端口占用：

sudo netstat -tulnp | grep 27017  # 查看端口占用进程
sudo lsof -i :27017               # 替代命令（更直观）

若端口被占用，可停止占用进程（sudo kill -9 <PID>）或修改MongoDB配置文件中的net.port。

检查防火墙：
若使用ufw防火墙，需允许27017端口：

sudo ufw allow 27017/tcp          # 允许TCP连接
sudo ufw reload                   # 重新加载防火墙规则

6. 使用内置工具监控性能

针对性能问题（如查询慢、响应时间长），可使用MongoDB自带工具进行监控：

mongostat：实时显示每秒操作数（插入、查询、更新等）、内存使用、网络流量等指标；
```
mongostat --host 127.0.0.1:27017  # 监控本地实例
```
mongotop：显示每个数据库/集合的读写时间，定位资源消耗大的集合；
```
mongotop --host 127.0.0.1:27017
```
explain命令：分析查询计划，判断是否使用了索引（如db.collection.find().explain("executionStats")）。

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

MongoDB的性能受系统资源限制，需通过以下命令检查资源占用：

CPU/内存：top、htop（实时查看进程资源占用）；
磁盘I/O：vmstat 1（查看磁盘读写速率）、iostat -x 1（详细I/O统计）；
磁盘空间：df -h（查看磁盘剩余空间，需预留足够空间给WiredTiger存储引擎）。
若资源不足（如内存耗尽、磁盘满），需扩容或优化配置（如调整storage.wiredTiger.engineConfig.cacheSizeGB）。

8. 常见问题针对性解决

连接问题（Connection refused）：确认服务已启动（systemctl status mongod）、端口正确（netstat -tulnp | grep 27017）、防火墙允许连接（ufw allow 27017）；
性能慢（Query performance issue）：使用explain()分析查询计划，添加合适索引（如db.collection.createIndex({field: 1})），优化查询语句（避免全表扫描）；
数据一致性问题（Write concern failed）：检查副本集状态（rs.status()），确认主从同步正常，重试失败操作；
服务无法启动：优先查看日志（/var/log/mongodb/mongod.log），常见原因包括配置文件错误、数据目录权限不足、端口冲突。