Debian MongoDB故障排查技巧有哪些

Debian 上 MongoDB 故障排查技巧

一 快速定位流程

• 检查服务状态：使用命令查看是否运行、是否崩溃重启、是否有启动失败的关键字。示例：sudo systemctl status mongod。若失败，优先看服务的详细日志输出。
• 查看服务日志：MongoDB 默认日志路径为 /var/log/mongodb/mongod.log，结合 tail -f /var/log/mongodb/mongod.log 实时观察；必要时用 grep "error\|fail\|exception" /var/log/mongodb/mongod.log 过滤关键信息。
• 核对配置文件：打开 /etc/mongod.conf，重点检查 net.bindIp、net.port、storage.dbPath、systemLog.path、processManagement.fork、security.authorization 等关键项是否与实际环境一致。
• 验证本地连通：在服务器本机执行 mongo --host 127.0.0.1 --port 27017 或 mongosh（新版本），确认本地能连上再排查远程。
• 复核权限与目录：确认 /var/lib/mongodb 与 /var/log/mongodb 属主为 mongodb:mongodb，目录存在且权限正确，避免因权限导致启动或写入失败。
• 变更后重启并观察：sudo systemctl restart mongod，再次查看状态与日志确认恢复。

二 连接问题专项排查

• 服务与端口：确认 mongod 已启动并监听 27017；若端口未监听，多半是配置或权限问题导致进程未成功绑定。
• 绑定地址与防火墙：在 /etc/mongod.conf 的 net 段核对 bindIp，需要远程访问时避免使用仅 127.0.0.1；如使用防火墙（如 iptables/ufw），放行 27017/tcp。示例：sudo ufw allow 27017 或 sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT。
• 连接字符串与驱动：核对应用连接串中的 主机名/IP、端口、数据库名、用户名、密码 是否正确；确保驱动版本与服务器版本兼容，必要时升级驱动。
• 认证与授权：若启用 security.authorization: enabled，需先以具备权限的用户登录（如 admin）再执行操作；验证用户权限与角色是否正确。
• 常见报错速解：
  • “Connection refused”：服务未启动或端口未监听、bindIp 限制、防火墙阻断。
  • “No Server Chosen by ReadPreference …”：检查 ReadPreference 设置与副本集/分片拓扑是否可达。

三 性能与稳定性问题排查

• 资源与负载：用系统工具监控 CPU、内存、磁盘 I/O、网络；MongoDB 为内存敏感型，磁盘 IOPS 不足常导致查询抖动。
• 内置监控：使用 mongostat 观察 insert/query/update/delete 速率、连接数、页面错误等；用 mongotop 查看集合级别的读写耗时。
• 查询与索引：对慢查询使用 explain("executionStats") 分析执行计划，补充或调整索引，尽量使用覆盖索引，避免全表扫描与无限制返回。
• 慢查询日志与 Profiling：配置并分析慢查询日志，按需开启数据库 Profiling 定位长耗时操作。
• 存储引擎与缓存：如使用 WiredTiger，在 /etc/mongod.conf 调整 storage.wiredTiger.engineConfig.cacheSizeGB，在内存与业务间取得平衡。
• 架构层面：数据量大或并发高时考虑 副本集/分片 提升可用性与扩展性。

四 常见错误与修复清单

五 排障小技巧与后续优化

• 日志组件与动态查看：在 Shell 中使用 db.getLogComponents() 查看日志组件，或用 db.adminCommand({ getLog: "componentName" }) 拉取指定组件日志，提升定位效率。
• 变更与升级：修改配置或升级版本前先备份数据与配置；变更后 systemctl restart mongod 并持续观察日志。
• 预防性优化：合理设置 WiredTiger 缓存、为高频查询建立合适索引、减少返回字段与避免全表更新，结合 mongostat/mongotop 与 Profiling 持续巡检。