Spring Boot 3 + Testcontainers MongoDB容器认证失败问题求助

核心问题定位 #

你的问题根源在于Testcontainers启动MongoDB容器时未正确初始化用户，同时Spring Boot配置层级存在错误，导致认证时找不到对应库的用户。

具体解决步骤 #

1. 修正Spring Boot配置层级 #

你提供的配置格式不符合Spring Boot 3的MongoDB配置规范，正确的配置结构应该是：

spring:
  data:
    mongodb:
      # 方式1：使用连接字符串（推荐，避免层级错误）
      uri: mongodb://admin:admin@localhost:49123/test?authSource=admin
      # 方式2：分参数配置
      # host: localhost
      # port: 49123
      # username: admin
      # password: admin
      # database: test
      # authentication-database: admin

原配置中的mongodb: main:层级错误，Spring Boot不会识别该配置段，导致用户名密码未生效。

2. 让Testcontainers自动初始化Root用户 #

MongoDB官方镜像支持通过环境变量在容器首次启动时创建Root用户，直接在Testcontainers容器定义中添加环境变量即可：

@Container
static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:6.0.13-jammy")
        .withEnv("MONGO_INITDB_ROOT_USERNAME", "admin")
        .withEnv("MONGO_INITDB_ROOT_PASSWORD", "admin")
        .withEnv("MONGO_INITDB_DATABASE", "admin");

这样容器启动时会自动在admin库创建admin用户，与你配置的authentication-database: admin完全匹配。

3. 若使用初始化脚本，确保正确挂载和执行 #

如果需要创建非Root用户（比如test库的专属用户），需将初始化脚本挂载到容器的/docker-entrypoint-initdb.d/目录，且仅在容器首次启动（数据卷为空）时执行：

• 在src/test/resources下创建init-mongo.js脚本：

// 切换到test库
use test;
// 创建test库的读写用户
db.createUser({
  user: "testuser",
  pwd: "testpass",
  roles: [{ role: "readWrite", db: "test" }]
});

• 在Testcontainers容器定义中挂载脚本：

mongoDBContainer.withCopyFileToContainer(
        MountableFile.forClasspathResource("init-mongo.js"),
        "/docker-entrypoint-initdb.d/init-mongo.js"
);

• 注意：如果之前启动过该容器，需清理Testcontainers自动生成的数据卷（可通过docker volume prune清理未使用的卷），确保脚本重新执行。

4. 验证容器内用户是否存在 #

进入容器手动检查用户是否创建成功：

# 替换<container-id>为你的MongoDB容器ID
docker exec -it <container-id> mongosh -u admin -p admin admin
# 执行命令查看admin库下的用户
db.getUsers()
# 若检查test库用户，切换库后执行
use test;
db.getUsers()

确认用户存在后，再匹配Spring Boot配置即可。

5. 连接字符串必须指定认证源 #

无论用哪种配置方式，都要确保认证源指向用户所在的库：

• 若用户在admin库，连接字符串需加?authSource=admin
• 若用户在test库，连接字符串需加?authSource=test
  否则MongoDB会默认用连接的目标库（如test）查找用户，导致认证失败。

内容的提问来源于stack exchange，提问作者Aleksei Mokhov