Debian 上安装 MongoDB 的实用排错与解决指南
一 标准安装步骤
- 更新系统并安装必要依赖：sudo apt update && sudo apt install -y apt-transport-https ca-certificates gnupg curl
- 导入 MongoDB 官方 GPG 密钥（示例为 6.0，可按需替换为 5.0/7.0）：wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
- 添加官方 APT 源（注意选择与系统代号一致的发行版，如 bullseye；架构按需保留 amd64/arm64）：echo “deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/debian bullseye/mongodb-org/6.0 multiverse” | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
- 更新索引并安装：sudo apt update && sudo apt install -y mongodb-org
- 启动与开机自启：sudo systemctl start mongod && sudo systemctl enable mongod
- 验证：sudo systemctl status mongod；mongo --eval ‘db.runCommand({ connectionStatus: 1 })’
二 常见报错与对应解决
-
apt 找不到包或报 404
- 原因：未添加官方源、发行版代号不匹配、或源路径错误（如误用 Ubuntu 源）。
- 解决：核对系统代号（如 buster/bullseye），使用对应 Debian 源；删除错误源文件后重新 apt update；必要时 apt clean && apt update。
-
安装冲突与残留包
- 现象：dpkg 报依赖冲突、held broken packages。
- 解决：彻底清理旧版与冲突包（示例：sudo apt purge -y mongodb* mongod* mongodb-org*），清理残留数据目录（谨慎：sudo rm -rf /var/lib/mongodb），再按标准步骤重装。
-
GPG 公钥或签名验证失败
- 现象：NO_PUBKEY、签名无法验证。
- 解决：安装/升级 gnupg（sudo apt install -y gnupg），重新导入对应版本的 GPG 密钥（如 server-6.0.asc），再 apt update。
-
依赖库不满足（如 libssl 版本）
- 现象：mongodb-org-server 依赖 libssl1.1 而系统仅有 libssl3。
- 解决：优先选择与系统库兼容的 MongoDB 版本；若必须安装较新版本，可在测试环境评估后手动安装所需旧库（如 libssl1.1 的 .deb 包），或考虑容器化部署以隔离依赖。
-
服务无法启动
- 排查：查看状态与日志（sudo systemctl status mongod；tail -f /var/log/mongodb/mongod.log），核对配置文件 /etc/mongod.conf 的路径、权限与端口（默认 27017），必要时修正目录权限后重启。
三 版本选择与兼容性要点
- 选择与 Debian 版本代号一致的官方源路径（如 buster/bullseye），避免误用 Ubuntu 源导致 404 或依赖错配。
- 选择与系统 glibc/openssl 兼容的 MongoDB 版本；较新发行版上直接使用过新版本可能触发 libssl 等底层依赖不满足，需评估降级版本或采用容器化方案。
四 快速验证与后续安全配置
- 连通性与状态：sudo systemctl status mongod；mongo --eval ‘db.runCommand({ connectionStatus: 1 })’
- 防火墙放行：sudo ufw allow 27017（如启用防火墙）
- 启用认证：编辑 /etc/mongod.conf，在 security 段设置 authorization: enabled，重启服务；随后在 mongo shell 中创建管理员用户并基于该用户连接。
