MongoDB故障排查在Debian上如何操作

Debian上MongoDB故障排查实操手册

一 快速定位流程

• 检查服务状态：运行sudo systemctl status mongod，若未运行则执行sudo systemctl start mongod；异常时优先查看服务日志与退出码。
• 查看服务日志：使用tail -f /var/log/mongodb/mongod.log实时观察启动失败、权限、配置错误等关键信息。
• 本地连通性自检：在服务器本机执行mongo --eval ‘db.runCommand({ connectionStatus: 1 })’，确认实例可连且认证正常。
• 远程连通性自检：从客户端执行mongo “mongodb://:27017”，若失败，转向网络与防火墙排查。
• 复核配置与权限：核对**/etc/mongod.conf中网络绑定、端口、存储路径，以及数据/日志目录属主是否为mongodb:mongodb**。
• 仍未定位：提高日志级别至1–2复现问题，再回落以减少干扰。
  以上步骤覆盖了服务、日志、连通性与配置四个维度，可快速缩小问题范围。

二 连接问题专项排查

• 服务与端口：确认mongod已启动并监听27017（或配置文件中自定义端口）；必要时重启服务sudo systemctl restart mongod。
• 绑定地址：在**/etc/mongod.conf的net.bindIp中确保包含应用来源IP，或临时设为0.0.0.0**进行连通性验证（生产环境请按白名单收敛）。
• 防火墙与安全组：
  • UFW：sudo ufw allow 27017；
  • iptables：sudo iptables -A INPUT -p tcp --dport 27017 -j ACCEPT。
• 连接字符串：校验主机名/IP、端口、数据库名、用户名、密码是否正确；示例：
  mongodb://admin:password@your_host:27017/your_db
• 认证与角色：确认用户存在、密码正确且具备所需角色/权限；必要时在本地先完成鉴权再测试。
• 驱动与驱动版本：应用驱动需与服务器版本兼容，升级驱动后复测。
• 常见报错速解：
  • Connection refused：服务未起/端口不对/被防火墙拦截；
  • No Server Chosen by ReadPreference：检查ReadPreference与副本集/分片拓扑；
  • Write concern failed：检查副本集成员状态与写入关注级别。
    以上要点可系统化排除“连不上”的根因。

三 性能与稳定性排查

• 资源瓶颈：同步观察CPU、内存、磁盘I/O、网络带宽，识别swap、IOPS、带宽饱和等诱因。
• 内置监控：使用mongostat（吞吐/延迟/队列）与mongotop（集合级耗时）定位热点操作。
• 查询与索引：对慢查询使用**explain()**分析执行计划，补充/调整索引，避免全表扫描。
• 慢查询日志：在**/etc/mongod.conf**中开启并合理设置阈值，持续收集并分析慢操作。
• 日志级别与组件：通过db.setLogLevel()与db.getLogComponents()临时提升command/network/query等组件的日志级别，复现后回落以减少开销。
• 版本与已知问题：评估升级到稳定版本以规避已修复缺陷。
  以上方法覆盖性能观测、查询优化与版本治理三个层面。

四 日志与配置要点

• 日志配置：在**/etc/mongod.conf**中设置
  systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log
  verbosity: 1
• 动态调级：
  • 查看组件级日志级别：db.getLogComponents()；
  • 设置全局或组件级别：如db.setLogLevel(2)或db.setLogLevel(1, “query”)。
• 日志轮转：使用logrotate管理**/var/log/mongodb/mongod.log**，示例策略：
  /var/log/mongodb/mongod.log {
  daily; rotate 7; compress; missingok; notifempty;
  sharedscripts; copytruncate; dateext; size 200M;
  postrotate /bin/kill -SIGUSR1 $(cat /var/run/mongod.pid 2>/dev/null || cat /var/log/mongodb/mongod.lock 2>/dev/null)
  }
• 日志分析：结构化日志可配合jq做字段筛选与统计，便于定位高频慢查询与异常堆栈。
  以上配置与操作可确保日志“可写、可读、可轮转、可分析”。

五 常见错误与修复对照表