MongoDB在Ubuntu上运行出错的排查与修复指南
一、快速定位问题
- 查看服务状态与日志，优先从日志拿到错误关键词：
- 查看状态：sudo systemctl status mongod
- 实时看日志：sudo tail -n 100 /var/log/mongodb/mongod.log
- 检查端口是否被占用（默认端口 27017）：
- 查看占用：sudo lsof -i :27017 或 ss -ltnp | grep 27017
- 核对配置文件路径与关键项：/etc/mongod.conf（常见项：dbPath、logPath、port、bindIp）
- 若服务启动失败且提示端口占用，先释放端口再启动（见下文“端口冲突”）。
二、常见错误与对应修复
- 端口冲突（systemd 报 code=exited, status=48 或启动失败）
- 释放端口：sudo kill -9 $(sudo lsof -t -i:27017)（仅在确认无业务影响时执行）
- 或修改 /etc/mongod.conf 的 port，再启动：sudo systemctl start mongod
- 非法关闭后无法启动（残留锁文件或数据不一致）
- 删除锁文件：sudo rm /var/lib/mongodb/mongod.lock
- 以修复模式启动并重建损坏数据：sudo mongod -f /etc/mongod.conf --repair
- 正常启动：sudo systemctl start mongod
- 磁盘空间不足导致启动失败（日志含 “Insufficient free space for journal files”）
- 临时方案：在配置中启用 smallfiles = true 或启动加 –smallfiles
- 根治方案：清理磁盘或扩容后再启动
- 数据目录不存在或权限错误（日志含 “NonExistentPath” 或 “Permission denied”）
- 创建目录并赋权（路径以你的配置为准，常见为 /var/lib/mongodb 与 /var/log/mongodb）：
- sudo mkdir -p /var/lib/mongodb /var/log/mongodb
- sudo chown -R mongodb:mongodb /var/lib/mongodb /var/log/mongodb
- 架构或版本不兼容（日志含 “Illegal instruction” 等信号错误）
- 核对系统架构（如 x86_64/ARM）与 MongoDB 版本匹配，必要时更换兼容版本后重装。
三、标准修复流程清单
- 备份数据与配置：复制 /var/lib/mongodb 与 /etc/mongod.conf 到安全位置。
- 查看并定位错误：sudo tail -n 100 /var/log/mongodb/mongod.log。
- 处理端口冲突：用 lsof/ss 确认占用并释放，或临时改端口。
- 处理异常关闭：删除 mongod.lock 并用 –repair 修复。
- 修复权限与目录：确保 dbPath/logPath 存在且属主为 mongodb:mongodb。
- 空间不足：启用 smallfiles 或扩容磁盘。
- 启动与验证：sudo systemctl start mongod；sudo systemctl status mongod；ss -ltnp | grep 27017。
- 仍失败时：保留日志，按错误关键词搜索或在社区提问。
四、预防与运维建议
- 关闭数据库请使用正常方式（如 db.shutdownServer() 或 systemd 停止），避免使用 kill -9，以免产生锁文件或数据不一致。
- 为 /var/lib/mongodb 与 /var/log/mongodb 配置合适的磁盘空间与监控告警，避免因空间不足导致宕机。
- 将关键配置（如 bindIp、port、storage.dbPath、systemLog.path）纳入版本管理与变更评审，减少配置漂移。
- 定期巡检与备份（如每日全量/增量备份与恢复演练），降低故障恢复时间。