使用Testcontainers测试MongoDB副本集时遇主机未知错误

这是MongoDB ReplicaSet的主机名暴露机制导致的典型问题，核心逻辑如下：

• MongoDB ReplicaSet初始化时，会将节点的**内部容器主机名（如你看到的3c43de90b922）**注册到集群配置中。当应用通过Testcontainers生成的外部连接字符串连接主节点后，主节点会把包含内部主机名的集群节点列表返回给客户端。
• 你的应用运行在容器外部（或独立容器网络），无法解析MongoDB容器的内部主机名——这些主机名仅在Testcontainers创建的Docker内部网络中有效，外部环境没有对应的DNS映射。
• 尽管ReactiveMongoTemplate的初始连接字符串是正确的（指向容器暴露的外部端口和主机），但MongoDB客户端会自动切换到ReplicaSet返回的内部节点地址，最终因无法解析抛出MongoSocketException。

针对Testcontainers场景，有两种可靠解决方式：

方式1：使用Testcontainers官方MongoDB ReplicaSet模块 #

Testcontainers提供的MongoDBReplicaContainer会自动处理主机名映射问题，无需手动配置：

// 示例代码片段
MongoDBReplicaContainer replicaSet = new MongoDBReplicaContainer("mongo:6.0")
    .withReplicaSetConfig("rs0");
replicaSet.start();

// 获取已处理主机名映射的连接字符串
String connectionString = replicaSet.getReplicaSetUrl();

该模块会自动修改MongoDB的节点配置，将内部主机名替换为Testcontainers暴露的外部主机（通常是localhost）和映射端口，确保客户端能正确解析所有节点地址。

方式2：手动配置主机名映射（自定义ReplicaSet场景） #

如果必须使用自定义MongoDB ReplicaSet配置，需要两步操作：

1. 启动MongoDB容器时，添加extraHosts参数，将容器内部主机名映射到宿主机IP：

Container<?> mongoNode = new GenericContainer<>("mongo:6.0")
    .withExtraHosts("3c43de90b922:127.0.0.1") // 替换为实际容器内部主机名
    .withCommand("--replSet rs0");

2. 初始化ReplicaSet时，使用宿主机IP而非内部主机名定义节点：

// 执行初始化ReplicaSet的命令
rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "127.0.0.1:27017" }, // 使用宿主机IP和暴露的端口
    { _id: 1, host: "127.0.0.1:27018" }
  ]
})

这样MongoDB返回给客户端的节点地址都是外部可访问的，不会出现解析失败的问题。

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