相同配置下TestContainers启动Mongo失败，Docker Compose正常

TestContainers 的 MongoDBContainer 默认会尝试初始化单节点副本集，但你的自定义 mongod.conf 未配置副本集相关参数，同时容器内的日志目录可能存在权限问题，最终导致副本集初始化失败，抛出 ReplicaSetInitializationException。

1. 调整自定义配置（可选，解决权限/路径问题） #

如果要保留自定义 mongod.conf，需确保容器内目录有权限，或简化配置适配容器环境：

storage:
  dbPath: /data/db  # 使用容器默认数据目录，避免权限冲突

systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log

processManagement:
  timeZoneInfo: /usr/share/zoneinfo

# 不需要添加 replication 配置，明确使用单实例模式

也可以直接移除 systemLog 配置，使用容器默认日志输出，方便TestContainers排查问题。

2. 修改 TestContainers 代码，禁用副本集初始化 #

通过覆盖启动命令，让 mongod 以纯单实例模式运行，跳过副本集初始化逻辑：

public MongoDBContainer mongoDBContainer() {
    return new MongoDBContainer("mongo:8.0.4-noble")
        .withEnv("MONGO_INITDB_ROOT_USERNAME", "mongo")
        .withEnv("MONGO_INITDB_ROOT_PASSWORD", "mongo")
        .withEnv("MONGO_INITDB_DATABASE", "mongo")
        .withCopyFileToContainer(
            forClasspathResource("/mongo/mongod.conf"), "/etc/mongod.conf"
        )
        .withCopyFileToContainer(
            forClasspathResource("/mongo/mongo-init.js"), "/docker-entrypoint-initdb.d/mongo-init.js"
        )
        // 覆盖启动命令，用自定义配置启动单实例，不初始化副本集
        .withCommand("mongod --config /etc/mongod.conf --noReplSet")
        .waitingFor(Wait.forListeningPort())
        .withReuse(true);
}

如果不需要自定义 mongod.conf，可以简化为：

public MongoDBContainer mongoDBContainer() {
    return new MongoDBContainer("mongo:8.0.4-noble")
        .withEnv("MONGO_INITDB_ROOT_USERNAME", "mongo")
        .withEnv("MONGO_INITDB_ROOT_PASSWORD", "mongo")
        .withEnv("MONGO_INITDB_DATABASE", "mongo")
        .withCopyFileToContainer(
            forClasspathResource("/mongo/mongo-init.js"), "/docker-entrypoint-initdb.d/mongo-init.js"
        )
        // 直接禁用副本集初始化
        .withReplicaSet(null)
        .waitingFor(Wait.forListeningPort())
        .withReuse(true);
}

3. 日志排查（启动失败时用） #

如果仍有问题，可打印容器日志定位具体错误：

MongoDBContainer container = mongoDBContainer();
container.start();
System.out.println(container.getLogs());

常见问题包括配置语法错误、目录权限不足等。

• TestContainers 默认创建单节点副本集，是为了兼容多数客户端的副本集连接模式；
• 若仅需纯单实例，必须显式禁用副本集初始化，或在配置中添加副本集参数并允许TestContainers完成初始化；
• 容器内自定义目录需确保 mongodb 用户有读写权限，否则会导致启动失败。

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