Ubuntu 22.04按官方文档安装MongoDB启动服务报错如何解决

问题场景 #

• 系统环境：Ubuntu 22.04
• 安装流程：参照MongoDB官方Ubuntu安装文档完成全流程安装操作，前期步骤无报错
• 故障现象：执行MongoDB服务启动操作时失败，错误界面见下图：
  

排查步骤 #

先执行以下命令拉取服务端详细错误日志，定位具体故障原因，不要仅凭启动失败的通用提示判断问题：
journalctl -u mongod --no-pager -n 50

高频故障对应修复方案 #

• 依赖库不兼容：Ubuntu 22.04默认预装libssl3，6.0及以下版本的MongoDB依赖libssl1.1，缺失时会报库文件找不到的错误，执行以下命令补装依赖：

  wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb
  sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
  

• 目录权限配置错误：MongoDB服务默认以mongodb用户身份运行，若默认数据目录/var/lib/mongodb、日志目录/var/log/mongodb属主不正确，会触发权限拒绝错误，执行命令修复权限：

  sudo chown -R mongodb:mongodb /var/lib/mongodb
  sudo chown -R mongodb:mongodb /var/log/mongodb
  

• 异常残留锁文件：如果之前存在强制终止MongoDB进程、系统异常掉电等情况，数据目录下的mongod.lock锁文件残留会阻止服务启动，先确认无运行中的MongoDB进程后删除残留文件：

  sudo pkill -9 mongod
  sudo rm -f /var/lib/mongodb/mongod.lock
  

• 配置文件语法错误：若手动修改过/etc/mongod.conf配置文件，语法错误会直接导致启动失败，执行以下命令可以直接定位配置错误的具体位置：
  sudo mongod --config /etc/mongod.conf --eval "db.version()"
  根据输出提示修正配置项即可。

修复后验证 #

所有问题修复完成后，依次执行以下命令重启服务并验证状态：

sudo systemctl daemon-reload
sudo systemctl start mongod
sudo systemctl is-active mongod

命令输出active即代表服务启动正常，可执行mongosh连接实例验证功能可用性。

内容的提问来源于stack exchange，提问作者Ajay Mathew