CentOS MongoDB故障如何排查

CentOS环境下MongoDB故障排查指南

MongoDB在CentOS上的故障排查需围绕服务状态、配置正确性、资源可用性、权限设置等核心维度展开，以下是系统化的排查步骤：

1. 检查MongoDB服务运行状态

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

sudo systemctl status mongod

若服务未启动，尝试启动服务并设置开机自启：

sudo systemctl start mongod
sudo systemctl enable mongod

启动失败时，需结合日志进一步分析原因。

2. 查阅日志定位具体错误

MongoDB的日志文件是故障排查的关键线索，默认路径为/var/log/mongodb/mongod.log。使用以下命令实时查看日志末尾内容：

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

若日志文件无法访问，可检查系统日志（通过journalctl）获取关联信息：

sudo journalctl -xe | grep mongod

日志中常见的错误包括配置文件语法错误、数据目录权限问题、端口冲突等。

3. 验证配置文件的正确性

MongoDB的主配置文件路径为/etc/mongod.conf，需重点检查以下关键配置项：

• storage.dbPath：数据存储目录是否存在且路径正确（如/var/lib/mongo）；
• net.port：监听端口（默认27017）是否未被其他进程占用；
• net.bindIp：绑定IP地址（如0.0.0.0允许远程连接，127.0.0.1仅本地访问）；
• systemLog.path：日志文件路径是否可写。
  配置文件修改后，需重启服务使变更生效：

sudo systemctl restart mongod

可使用在线YAML验证工具检查配置文件语法是否正确。

4. 排查端口占用问题

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

sudo netstat -tuln | grep 27017
# 或使用lsof命令
sudo lsof -iTCP -sTCP:LISTEN -n -P | grep 27017

若端口被占用，可通过kill命令终止占用进程（需确认进程合法性）：

sudo kill -9 <PID>

或修改MongoDB配置文件中的net.port为其他可用端口。

5. 检查数据目录权限

MongoDB进程需对数据目录（如/var/lib/mongo）拥有读写权限，否则会导致启动失败。使用以下命令修复权限：

sudo chown -R mongod:mongod /var/lib/mongo
sudo chmod -R 755 /var/lib/mongo

若数据目录路径被修改，需同步更新配置文件中的storage.dbPath并重启服务。

6. 确认系统资源充足性

系统资源不足（如磁盘空间耗尽、内存不足）会导致MongoDB无法正常运行：

• 检查磁盘空间：使用df -h命令查看磁盘剩余空间，确保数据目录所在分区有足够空间（建议保留至少10%空闲空间）；
• 检查内存使用：使用free -h或top命令查看内存占用情况，若内存不足，可调整MongoDB的wiredTiger缓存大小（在配置文件中设置storage.wiredTiger.engineConfig.cacheSizeGB）。

7. 处理SELinux限制（若启用）

若系统启用了SELinux（sestatus显示Enforcing模式），可能会阻止MongoDB访问数据目录或端口。可临时将SELinux设置为permissive模式排查问题：

sudo setenforce 0

若问题解决，需调整SELinux策略或永久禁用（修改/etc/selinux/config中的SELINUX=disabled，需重启系统）。对于数据目录权限问题，可使用以下命令修复安全上下文：

sudo chcon -Rv --type=mongod_var_lib_t /var/lib/mongo

8. 使用MongoDB内置工具诊断

MongoDB提供了多种内置工具用于性能监控和状态检查：

• mongostat：实时监控数据库操作统计（如查询、插入、更新次数）；
• mongotop：监控集合级别的读写时间，定位慢查询；
• db.serverStatus()：在MongoDB shell中执行，获取实例详细状态（包括锁、内存、连接数等）；
• db.runCommand({logRotate: 1})：手动触发日志轮转，避免日志文件过大。

9. 分析崩溃转储（若发生崩溃）

若MongoDB发生崩溃，系统会生成内核转储文件（通常位于/var/crash目录），可使用crash工具分析转储文件（需安装crash和内核调试符号）：

sudo yum install crash kernel-debuginfo-$(uname -r)
sudo crash /usr/lib/debug/lib/modules/$(uname -r)/vmlinux /var/crash/vmcore

通过分析转储文件可定位崩溃原因（如内核bug、内存损坏）。

10. 其他常见问题排查

• 连接失败：检查防火墙是否开放27017端口（sudo firewall-cmd --add-port=27017/tcp --permanent && sudo firewall-cmd --reload）；确认认证信息（用户名、密码、数据库）是否正确；
• 版本问题：若使用旧版本MongoDB，建议升级到最新稳定版（修复已知bug）；
• 重新安装：若以上步骤均无法解决，可卸载并重新安装MongoDB（需提前备份数据）。

通过以上步骤可系统化排查CentOS环境下MongoDB的常见故障，关键是根据日志和错误信息定位具体原因，针对性解决。若问题仍无法解决，建议参考MongoDB官方文档或联系技术支持。