配置正确凭证仍无法认证MongoDB数据库的排查求助

核心问题 #

你遇到的认证失败有两个关键原因：

1. Docker环境变量拼写错误 #

你的docker-compose.yml里的数据库初始化变量写错了：

MONGO_INIDB_DATABASE: testdatabase

正确的变量名应该是MONGO_INITDB_DATABASE（少了一个字母T），这个错误会导致初始化逻辑无法识别你指定的数据库，同时root用户默认会被创建在admin系统数据库中。

2. 认证源不匹配 #

Spring Boot连接字符串中，你指定了testdatabase作为目标数据库，但没有指定认证源。MongoDB默认会在目标数据库中查找用户，而root用户实际存储在admin库中，所以数据库找不到该用户，导致认证失败。

修复步骤 #

步骤1：修正Docker Compose配置 #

修改docker-compose.yml中的环境变量拼写：

version: '3.1'

services:
  mongotest:
    image: mongo:4.4.4
    restart: unless-stopped
    ports:
      - 27017:27017
    volumes:
      - ~/software/mongobase/mongodata:/data/db
      - ~/software/mongobase/logs:/root/logs
      - ~/software/mongobase/mongod.conf:/etc/mongod.conf
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: <redacted>
      MONGO_INITDB_DATABASE: testdatabase  # 修正拼写错误

步骤2：清理现有数据卷（重要） #

因为MongoDB的初始化脚本只会在第一次启动且数据卷为空时执行，所以如果你之前已经启动过容器，需要删除现有数据卷来重新初始化：

# 停止并删除容器
docker-compose down
# 删除数据卷（注意：这会清除现有数据库数据）
sudo rm -rf ~/software/mongobase/mongodata
# 重新启动容器
docker-compose up -d

步骤3：修正Spring Boot连接字符串 #

在application.properties中，给MongoDB URI添加authSource=admin参数，指定从admin库进行认证：

server.port=8080

spring.data.mongodb.uri=mongodb://root:<redacted>@myhost:27017/testdatabase?authSource=admin

可选：在testdatabase中创建独立用户（推荐用于生产） #

如果不想使用root用户连接业务数据库，可以自定义初始化脚本，在testdatabase中创建专用用户：

1. 创建初始化脚本init-mongo.js：

db.createUser({
  user: "appuser",
  pwd: "yourpassword",
  roles: [ { role: "readWrite", db: "testdatabase" } ]
});

2. 在docker-compose.yml中挂载脚本：

volumes:
  - ~/software/mongobase/mongodata:/data/db
  - ~/software/mongobase/logs:/root/logs
  - ~/software/mongobase/mongod.conf:/etc/mongod.conf
  - ~/software/mongobase/init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js  # 添加这行

3. 修改Spring Boot连接字符串为：

spring.data.mongodb.uri=mongodb://appuser:yourpassword@myhost:27017/testdatabase

内容的提问来源于stack exchange，提问作者Factor Three