Debian上MongoDB故障排查有哪些方法

Debian上MongoDB故障排查方法

一 快速定位流程

• 检查服务状态：使用命令查看 systemctl status mongod，若未运行则执行 sudo systemctl start mongod 并观察状态输出中的错误提示。
• 查看服务日志：定位日志文件 /var/log/mongodb/mongod.log，使用 tail -f /var/log/mongodb/mongod.log 实时跟踪，配合 grep “error|fail|exception” /var/log/mongodb/mongod.log 快速筛选异常。
• 验证监听与端口：确认进程是否在 27017 端口监听，执行 sudo netstat -anp | grep 27017；若端口被占用，处理占用进程或调整配置。
• 校验配置文件：检查 /etc/mongod.conf 中关键项（如 net.port、net.bindIp、storage.dbPath、systemLog.path）是否存在语法或路径错误。
• 权限与目录：确保 dbPath 与 systemLog.path 目录存在且属主为 mongodb:mongodb，否则创建并修正权限。
• 快速连通性自检：本地执行 mongo --eval ‘db.runCommand({ connectionStatus: 1 })’ 验证实例可连与鉴权状态。
• 异常恢复：异常关机或崩溃后，如出现 mongod.lock，先确认无其他 mongod 占用数据目录，再移除锁文件并启动；必要时从备份恢复。

二 连接问题排查

• 服务与端口：确认 mongod 已启动并监听 27017，必要时重启服务 sudo systemctl restart mongod。
• 绑定地址与端口：在 /etc/mongod.conf 的 net 段核对 bindIp（如需要远程访问可设为 0.0.0.0，生产环境建议白名单）、port；修改后重启。
• 防火墙与安全组：在 Debian 上检查 iptables 规则，放行 27017/tcp，例如：
  • 查看：sudo iptables -L -n
  • 放行：sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT
  • 保存/重启防火墙服务（视系统配置而定）。
• 连接字符串与应用侧：核对主机名/IP、端口、数据库名、用户名、密码、认证源（如 authSource）是否正确；必要时更新驱动版本以匹配服务器。
• 本地回环验证：先在服务器本机执行 mongo --host 127.0.0.1:27017 排除网络问题，再测试远程。

三 性能与查询问题排查

• 实时监控：使用 mongostat（吞吐、连接、锁等）与 mongotop（集合级读写耗时）定位热点与瓶颈。
• 慢查询：在 /etc/mongod.conf 的 operationProfiling 启用并设定阈值（如 slowOpThresholdMs: 100），通过日志或 db.system.profile 分析慢操作。
• 执行计划：对问题查询使用 explain(“executionStats”) 检查是否命中索引、扫描方式（COLLSCAN/IXSCAN）、执行时间与中间结果规模，据此增加或调整复合索引。
• 系统资源：同步观测 CPU、内存、磁盘 I/O、网络 使用率，排查页面置换、磁盘饱和、网络抖动等系统层瓶颈。

四 复制集与数据一致性排查

• 复制集状态：在 mongo 中执行 rs.status()，检查 members.stateStr、optime、lastHeartbeat 等字段，确认主从同步与健康度。
• 写入关注与一致性：遇到 Write concern failed 时，核对 w、wtimeout、journal 配置与副本集多数派可用性，必要时降低 w 或修复同步滞后成员。
• 回放与延迟：通过 rs.printReplicationInfo() 查看 oplog 大小与时间窗口，确认应用写入是否在 oplog 覆盖范围内；滞后节点优先排查网络、磁盘与负载。
• 读偏好：出现 No Server Chosen by ReadPreference 时，检查 ReadPreference 与副本集拓扑/成员状态是否匹配。

五 常见错误与处理清单