MongoDB Ubuntu 配置常见错误与排查要点
一 安装与软件源配置错误
- 使用系统自带包名安装时提示“没有可安装候选”，多因未添加 MongoDB 官方 APT 源或 GPG 密钥；正确做法是先导入密钥、添加对应 Ubuntu 发行版代号 的源（如 focal/xenial/bionic）、再执行
sudo apt update && sudo apt install -y mongodb-org。
- 导入密钥或添加源的命令写错（如 URL、密钥服务器或发行版代号不匹配）也会导致安装失败；核对命令中的 版本号 与 架构 是否匹配当前系统。
- 在较新系统上使用过旧或不被支持的 Ubuntu 版本/仓库，会出现找不到包或无法安装的情况；应确认 Ubuntu LTS 版本 是否被当前 MongoDB 版本支持，必要时更换为受支持的版本或仓库。
二 服务与权限类错误
- 使用
sudo service mongod start 时报错“Unit mongod.service not found”，多为包未正确安装或服务文件缺失；建议执行 sudo apt purge mongodb-org* 清理后重装，再 sudo systemctl start mongod。
- systemd 启动失败并提示“code=exited, status=14”，通常与 数据目录/日志目录 的属主或权限不正确有关；应将目录（如 /var/lib/mongodb、/var/log/mongodb）递归修改为运行 MongoDB 的系统用户（常见为 mongodb 或 mongod），例如：
sudo chown -R mongodb:mongodb /var/lib/mongodb /var/log/mongodb，再重启服务。
- 使用
kill -9 强杀进程后再次启动失败，常见原因是 mongod.lock 残留或数据文件不一致；应先确认无 mongod 进程后删除锁文件，并以 mongod --repair 修复，再正常启动。
- 非法关机或崩溃后启动报错，优先检查 journal 与数据一致性，必要时执行 –repair 重建损坏的数据与索引。
三 数据与磁盘空间问题
- 启动日志出现“Insufficient free space for journal files”，表示 磁盘空间不足 或 journal 文件增长受限；可临时使用
--smallfiles 启动，或为数据盘扩容，并清理无用数据/日志。
- 自定义 dbPath 指向不存在的路径或无权限目录，mongod 将无法初始化；应确保目录存在且运行用户具备读写权限，例如：
sudo mkdir -p /data/db && sudo chown $(whoami) /data/db。
- 使用压缩包解压方式运行时，若未设置 环境变量 PATH 或未指定 –dbpath，会出现“command not found”或“Data directory not found”等错误；需正确设置 PATH 或显式传入数据目录。
四 网络与远程访问配置错误
- 配置文件 /etc/mongod.conf 中
net.bindIp 默认为 127.0.0.1，导致只能本地连接；如需远程访问，应改为 0.0.0.0（或指定内网网段），并重启服务。
- 未启用 身份验证 即对外网开放，存在安全风险；应在配置中开启
security.authorization: enabled，并在 admin 库创建管理员用户后再远程连接。
- 服务器或云环境存在 防火墙/安全组 限制（如未放行 27017 端口），远程工具仍无法连接；需在 ufw/iptables 或云平台安全组中放行对应端口。
五 快速排查清单
- 查看服务状态与日志：
sudo systemctl status mongod、journalctl -u mongod.service，优先从日志定位错误关键词（如 permission、journal、address already in use）。
- 核对关键配置：
/etc/mongod.conf 中的 dbPath、logPath、bindIp、port、security.authorization，确保路径存在且属主正确。
- 校验目录权限与属主：数据目录与日志目录应归属 mongodb/mongod 且权限合理（如 755/750），必要时
chown -R 修复。
- 清理异常锁文件与修复：确认无 mongod 进程后删除 mongod.lock，必要时
mongod --repair。
- 远程访问：确认
bindIp、防火墙/安全组、以及已创建并启用 身份验证 的用户。