Spring Boot连接Docker Service部署的MongoDB副本集配置问题

看起来你已经通过Docker Service启动了3个Mongo节点，但要注意默认启动的Mongo节点不会自动组成副本集，得先完成副本集初始化，再调整Spring Boot的配置才能正常连接。下面一步步来：

第一步：初始化MongoDB副本集 #

你已经用docker service create --name mongo --replicas=3 mongo启动了服务，现在需要进入其中一个容器初始化副本集：

1. 先获取其中一个Mongo容器的ID，比如你提供的53cf3b73a510，进入容器：

docker exec -it 53cf3b73a510 mongosh

2. 在Mongo Shell里执行初始化命令（Docker Service下每个容器的主机名格式是服务名.序号，比如mongo.1、mongo.2、mongo.3）：

rs.initiate({
  _id: "mongo", // 这里要和你后续Spring配置的副本集名称一致
  members: [
    { _id: 0, host: "mongo.1:27017" },
    { _id: 1, host: "mongo.2:27017" },
    { _id: 2, host: "mongo.3:27017" }
  ]
})

执行后可以用rs.status()查看副本集状态，确认所有节点都正常加入（状态显示PRIMARY、SECONDARY即表示成功）。

第二步：调整Spring Boot的MongoDB配置 #

原来的单节点配置只指定了host和port，连接副本集推荐使用MongoDB URI的方式，这样能更清晰地指定副本集信息。同时注意：你原来的spring.mongodb.embedded.storage.repl-set-name=mongo是针对嵌入式Mongo的配置，现在用外部副本集可以删除这个配置，避免混淆。

推荐配置：使用URI #

在application.properties或application.yml中替换原来的host/port配置：

# 利用Docker Service的服务发现，直接通过服务名访问所有副本集节点
spring.data.mongodb.uri=mongodb://mongo:27017/your-database-name?replicaSet=mongo

• mongo是Docker Service的服务名，Docker的服务发现会自动解析到所有副本集节点
• replicaSet=mongo必须和你初始化副本集时的_id完全一致
• your-database-name替换成你实际使用的数据库名称（如果不需要指定可以省略这部分）

如果想明确指定所有节点，也可以写成：

spring.data.mongodb.uri=mongodb://mongo.1:27017,mongo.2:27017,mongo.3:27017/your-database-name?replicaSet=mongo

备选：拆分配置项 #

如果你偏好拆分配置，也可以这样写（但URI方式更直观）：

spring.data.mongodb.host=mongo
spring.data.mongodb.port=27017
spring.data.mongodb.database=your-database-name
spring.data.mongodb.replica-set-name=mongo

第三步：验证连接 #

重启你的Spring Boot应用，查看日志是否有类似Connected to replica set mongo with servers [mongo.1:27017, mongo.2:27017, mongo.3:27017]的成功提示。如果遇到连接问题，可以排查：

• 副本集是否初始化成功，所有节点状态正常（用rs.status()检查）
• Spring配置中的副本集名称和初始化时的_id完全匹配
• Docker服务的overlay网络是否正常（可以用docker network inspect查看服务所在网络）

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