Debian MongoDB故障排查指南 - 问答

Debian 上 MongoDB 故障排查指南

一快速定位流程

服务状态与端口
- 检查服务：sudo systemctl status mongod
- 查看监听：ss -ltnp | grep 27017 或 netstat -anp | grep 27017
日志与配置
- 查看日志：tail -f /var/log/mongodb/mongod.log
- 核对配置：/etc/mongod.conf 中的 net.port、net.bindIp、storage.dbPath、systemLog.destination
连接与网络
- 本机连接：mongo --host 127.0.0.1:27017
- 远程连通：mongo --host 服务器IP:27017
- 防火墙放行：sudo ufw allow 27017/tcp（或 iptables 放行相应端口）
资源与权限
- 磁盘空间：df -h；Inode：df -i
- 目录权限：ls -ld /var/lib/mongodb /var/log/mongodb；必要时 chown -R mongodb:mongodb /var/lib/mongodb /var/log/mongodb
运行时诊断
- 连接状态：mongo --eval ‘db.runCommand({ connectionStatus: 1 })’
- 性能快照：mongostat、mongotop

二常见故障与修复

服务无法启动
- 查看日志定位错误；核对 /etc/mongod.conf 路径与语法；确认 dbPath 存在且权限正确；若异常关机残留锁文件，确认无 mongod 进程后删除 mongod.lock 再启动（谨慎操作）。
Connection refused
- 服务未启动则启动；端口不对则核对 net.port；远程连不通则检查 bindIp（如需要远程访问可设为 0.0.0.0，并确保防火墙放行 27017）。
权限或认证失败
- 核对连接字符串中的用户名、密码、认证库；确保用户具备相应角色；必要时在 mongo shell 中 db.auth() 验证。
Write concern failed
- 副本集/分片环境检查节点健康与同步状态（rs.status()）、网络延迟与写入关注级别是否过高。
查询慢
- 使用 explain(“executionStats”) 分析执行计划；为高频查询字段建立合适索引；启用并分析慢查询日志；结合 mongostat/mongotop 观察吞吐与锁情况。

三日志与诊断命令清单

服务与端口
- systemctl status mongod；ss -ltnp | grep 27017
日志查看与检索
- tail -f /var/log/mongodb/mongod.log
- grep -i “error|fail|exception” /var/log/mongodb/mongod.log
- 组件日志：db.getLogComponents()；db.adminCommand({ getLog: “componentName” })
连接与状态
- mongo --host 127.0.0.1:27017 --eval ‘db.runCommand({ connectionStatus: 1 })’
- 副本集状态：rs.status()
性能与负载
- mongostat、mongotop
查询分析
- db.collection.find(…).explain(“executionStats”)

四配置与性能优化要点

网络与绑定
- 仅内网开放时，bindIp 绑定内网网段；远程访问需明确放行策略并做好鉴权。
存储与缓存
- 使用 SSD；根据内存合理设置 WiredTiger 缓存：storage.wiredTiger.engineConfig.cacheSizeGB（不超过物理内存的较大比例，留出系统与其他进程空间）。
索引与查询
- 为高频查询建立复合索引；避免过多索引；使用覆盖索引减少回表；用 explain 持续优化。
副本集与分片
- 数据可靠性与读扩展使用副本集；海量数据与高并发考虑分片，合理选择分片键。
监控与维护
- 长期开启慢查询日志与 Profiling；定期用 mongostat/mongotop、PMM 等监控；按需重建或清理低效索引。

五安全加固与维护建议

0 赞

0 踩