MongoDB在Debian中如何故障排查

MongoDB 在 Debian 的故障排查步骤

一 快速定位与通用检查

• 确认服务状态与端口监听：使用命令查看 MongoDB 是否运行、是否监听默认端口 27017，并检查配置文件与数据/日志目录权限。
  • 命令示例：
    • 查看服务状态：sudo systemctl status mongod
    • 启动/重启：sudo systemctl start|restart mongod
    • 查看监听端口：sudo netstat -anp | grep 27017
• 查看日志定位错误：默认日志路径为 /var/log/mongodb/mongod.log，使用 tail -f 实时观察启动或运行报错。
  • 命令示例：sudo tail -f /var/log/mongodb/mongod.log
• 核对配置文件：检查 /etc/mongod.conf 中关键项（如 net.port、net.bindIp、storage.dbPath、systemLog.path）是否与实际路径、端口一致，修改后需重启生效。
• 资源与连通性：确认 磁盘空间、内存、I/O 充足；若应用与数据库跨主机，先 ping 主机，再测试端口连通性（如 nc -vz <host> 27017）。

二 连接问题排查

• 服务与端口：确保 mongod 已启动并监听 27017；若未监听，优先检查日志与配置。
• 绑定地址与防火墙：在 /etc/mongod.conf 的 net.bindIp 中包含应用来源网段或临时设为 0.0.0.0（仅测试环境），并放行防火墙端口 27017。
  • 命令示例（iptables）：sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT
• 连接字符串与应用侧：核对 主机名/IP、端口、数据库名、用户名、密码 是否正确；必要时更新驱动版本以匹配服务器版本。
• 本机连通性测试：使用 mongo --host <host> --port 27017 或 mongosh 测试；远程连接失败优先检查网络路径与访问控制。

三 启动失败与崩溃排查

• 日志优先：查看 /var/log/mongodb/mongod.log 首屏报错，常见原因包括配置路径错误、权限不足、端口被占用、磁盘满等。
• 目录与权限：确认 storage.dbPath 与 systemLog.path 所在目录存在且属 mongodb 用户（或运行用户）；权限错误会导致启动立即退出。
• 端口冲突：使用 netstat -anp | grep 27017 检查是否被其他进程占用；如冲突，释放端口或修改 mongod.conf 的 port。
• 数据目录异常：若异常关机导致锁文件残留，可在确认无其它 mongod 进程后移除 mongod.lock，再启动（谨慎操作，先备份）。
• 配置语法与路径：核对 /etc/mongod.conf 的缩进、字段拼写与路径是否存在；修改后 sudo systemctl restart mongod 观察日志。

四 性能与查询问题排查

• 实时监控：使用 mongostat、mongotop 观察 insert/query/update/delete 速率、锁等待、内存与页面错误等，快速识别瓶颈。
• 慢查询与执行计划：开启并分析慢查询日志，使用 explain() 检查是否走索引、扫描方式（COLLSCAN/IXSCAN）与执行成本。
  • 建议：为高频查询建立复合索引，避免在大集合上进行无索引排序/聚合。
• 系统层面：结合 CPU、内存、磁盘 I/O、网络 指标排查资源瓶颈；必要时调整 WiredTiger 缓存、压缩、批量写入策略。

五 日志管理与版本兼容要点

• 日志配置与动态调级：在 /etc/mongod.conf 设置日志路径、追加模式与详细级别；在 Shell 中可动态调整与查看组件日志。
  • 配置示例：
    • systemLog: destination: file; logAppend: true; path: /var/log/mongodb/mongod.log; verbosity: 1
    • 查看组件日志级别：db.getLogComponents()
    • 动态获取组件日志：db.adminCommand({ getLog: "componentName" })
    • 手动轮转日志：db.runCommand({ logRotate: 1 })
• 日志轮转：使用 logrotate 管理 mongod.log（按日轮转、保留 7 天、压缩、发送 SIGUSR1 通知重新打开日志文件）。
  • 示例要点：
    • /var/log/mongodb/mongod.log { daily; rotate 7; compress; missingok; notifempty; sharedscripts; copytruncate; postrotate /bin/kill -SIGUSR1 $(cat /var/run/mongod.pid 2>/dev/null) 2>/dev/null || true; endscript }
• 版本兼容与升级：确保 MongoDB 版本 与 Debian 版本匹配，优先使用 官方 APT 仓库；升级前备份数据、按官方步骤执行，并在测试环境验证。