在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 已安装并可用，便于快速复核问题。
