Debian系统MongoDB故障排查步骤是什么

Debian 上 MongoDB 故障排查步骤

一 快速定位与通用检查

• 确认服务状态与启动失败原因：执行 sudo systemctl status mongod，若失败，优先查看 journalctl -xeu mongod 获取 systemd 报错细节。
• 查看 MongoDB 服务日志：默认路径 /var/log/mongodb/mongod.log，使用 tail -f /var/log/mongodb/mongod.log 实时观察错误。
• 校验配置文件：检查 /etc/mongod.conf 的语法与关键路径（如 systemLog.path、storage.dbPath、net.bindIp 与 net.port），必要时先备份再修改。
• 权限与目录：确保 dbPath 与 logPath 所属用户为 mongodb:mongodb，目录存在且权限正确，避免因权限导致启动失败。
• 网络连通性：本机测试 mongosh --host 127.0.0.1 --port 27017；远程连接需确认 bindIp 包含服务器 IP 或 0.0.0.0，并放通防火墙端口 27017（如 ufw allow 27017）。
• 客户端可用性：若提示 -bash: mongo: command not found，说明未安装或 PATH 未配置；MongoDB 5.0+ 推荐使用 mongosh，可执行 sudo apt install -y mongodb-mongosh 后使用 mongosh 连接。

二 常见故障场景与处理

• 服务无法启动
  • 检查 mongod.log 与 systemctl status 输出，定位配置错误、路径不存在或权限不足。
  • 核对 /etc/mongod.conf 中 dbPath/logPath 路径与权限（属主 mongodb:mongodb）。
  • 若 systemd 提示 PID 文件路径或 旧路径问题，按需调整服务文件并重新加载：执行 sudo systemctl daemon-reload，再尝试启动。
• 连接被拒绝 Connection refused
  • 确认服务已启动（systemctl is-active mongod）。
  • 核对 bindIp（是否允许远程或当前客户端 IP）与端口 27017。
  • 检查防火墙/云安全组是否放行 27017。
  • 本机先用 mongosh 直连 127.0.0.1:27017 排除网络问题。
• 认证与权限错误
  • 启用了鉴权时，连接字符串需包含 用户名/密码；在 mongosh 中先 use admin 再执行 db.auth(“user”,“pwd”) 验证凭据。
  • 使用 db.getUsers() 检查用户是否存在及角色权限。
• 副本集相关错误（如 No Server Chosen by ReadPreference、Write concern failed）
  • 检查 rs.status() 的 members 状态与网络连通性。
  • 确认 writeConcern 与 readPreference 配置与实际拓扑匹配。
• 性能问题（查询慢、负载高）
  • 使用 mongostat、mongotop 观察吞吐、延迟与锁情况。
  • 对慢查询使用 explain(“executionStats”) 分析执行计划并优化索引。
  • 配置并分析慢查询日志，必要时提高日志详细度以定位问题。

三 日志与诊断工具

• 日志查看与组件级别：

  • 实时查看：tail -f /var/log/mongodb/mongod.log；按关键字过滤：grep “error|fail|exception” /var/log/mongodb/mongod.log。
  • 动态调节日志级别与组件：在 mongosh 中执行 db.setLogLevel(1)，或按组件查看/调整：db.getLogComponents()、**db.adminCommand({ getLog: “componentName” })。

• 慢查询与日志轮转：

  • 通过 systemLog.verbosity 提高日志详细度，或在 mongosh 中临时提升以捕获问题语句。
  • 使用 logrotate 管理日志轮转（如 /etc/logrotate.d/mongodb），支持按日轮转、压缩与保留历史。
  • 需要手动切分日志时，可在 mongosh 执行 db.runCommand({ logRotate: 1 })。

四 配置与维护要点

• 关键配置核对：
  • systemLog.destination: file、systemLog.path、systemLog.logAppend；
  • storage.dbPath（确保目录存在且权限正确）；
  • net.bindIp（需要远程访问时设为 0.0.0.0 或服务器内网/公网 IP）、net.port（默认 27017）。
• 权限与安全：
  • 数据/日志目录属主应为 mongodb:mongodb；
  • 启用鉴权后，连接字符串包含凭据，并为应用分配最小权限角色。
• 升级与变更：
  • 变更前备份 dbPath 与配置；变更后执行 sudo systemctl daemon-reload 再重启服务；
  • 若问题持续，回滚到上一个稳定版本并复核变更项。

五 最小复现与求助准备

• 复现步骤：整理触发故障的操作、时间、连接字符串/参数、错误提示与 mongod.log 关键行。
• 环境信息：MongoDB 版本、Debian 版本、是否副本集/分片、相关配置片段（如 bindIp、security.authorization、replication）。
• 诊断输出：提供 systemctl status mongod、journalctl -xeu mongod、mongostat/mongotop 输出与慢查询的 explain 结果。
• 工具可用性：确认 mongosh 已安装并可用，便于快速复核问题。