首先确认MongoDB守护进程是否正在运行,使用以下命令查看服务状态:
sudo systemctl status mongod
若服务未启动,执行sudo systemctl start mongod启动;若需开机自启,执行sudo systemctl enable mongod。启动失败时,需进一步查看日志定位原因。
MongoDB的日志文件是故障排查的核心依据,默认路径为/var/log/mongodb/mongod.log。使用以下命令实时查看最新日志:
sudo tail -f /var/log/mongodb/mongod.log
重点关注ERROR或WARN级别的日志条目(如配置错误、权限问题、数据文件损坏等)。此外,系统日志(journalctl)也能提供关联信息:
sudo journalctl -xe | grep mongod
MongoDB的配置文件默认位于/etc/mongod.conf,需检查以下关键参数是否正确:
127.0.0.1仅允许本机连接,远程访问需修改为0.0.0.0或具体IP);27017,若修改需同步调整防火墙规则);sudo mongod --config /etc/mongod.conf --fork测试配置文件语法是否正确。确认MongoDB端口(默认27017)是否被占用:
sudo netstat -tulnp | grep 27017 # 或使用 ss -tulnp | grep 27017
若端口被占用,可通过kill -9 <PID>终止占用进程(需确认进程合法性)。
同时,检查防火墙是否允许该端口的入站连接(以firewalld为例):
sudo firewall-cmd --permanent --add-port=27017/tcp
sudo firewall-cmd --reload
MongoDB的数据目录(dbPath)需由mongod用户(或运行服务的用户)拥有读写权限。默认数据目录为/var/lib/mongo,执行以下命令修复权限:
sudo chown -R mongod:mongod /var/lib/mongo
sudo chmod -R 755 /var/lib/mongo
若数据目录被误删或损坏,需修复数据文件(详见“数据文件损坏处理”部分)。
MongoDB的性能受系统资源限制,需检查以下指标:
free -h查看内存剩余,若wiredTiger缓存(storage.wiredTiger.engineConfig.cacheSizeGB)设置过大导致OOM(内存溢出),需调整缓存大小(建议为系统内存的50%-60%);df -h查看磁盘剩余空间(需保留至少10%空闲空间);top或iotop查看CPU占用及磁盘I/O负载(若I/O利用率持续100%,需升级SSD或优化查询)。MongoDB提供了多个内置工具用于性能诊断:
mongo shell执行);net.maxIncomingConnections(默认65536)限制最大连接数,并优化应用程序的连接池配置(如复用连接);RECOVERING过久),需检查网络带宽、磁盘I/O(使用iftop、iostat),或通过rs.stepDown()强制主节点切换;mongod.lock文件(sudo rm /var/lib/mongo/mongod.lock),然后执行修复命令:sudo mongod --dbpath /var/lib/mongo --repair
修复完成后重启服务。若启用了SELinux(sestatus显示Enforcing),可能会阻止MongoDB访问数据目录或端口。可临时设置为Permissive模式排查(sudo setenforce 0),若问题解决,需调整SELinux规则(如chcon -Rv --type=mongod_var_lib_t /var/lib/mongo)或永久禁用(修改/etc/selinux/config中的SELINUX=disabled)。
以上步骤覆盖了CentOS下MongoDB的常见故障场景,排查时需逐步缩小范围,优先查看日志和系统资源,结合内置工具定位具体原因。若问题仍未解决,可参考MongoDB官方文档或社区论坛寻求帮助。