Spring Boot应用连接MongoDB只读副本节点启动失败问题咨询

问题根源 #

你遇到的这个情况其实很典型：纯Java MongoClient能正常连接只读secondary节点，但Spring Boot启动就报错，核心原因是Spring Data MongoDB在初始化阶段（比如创建MongoTemplate这类核心Bean时），默认会尝试寻找一个可写的主节点——哪怕你已经配置了secondaryPreferred的读偏好。当集群里只剩只读secondary、没有主节点时，客户端会一直等待匹配WritableServerSelector的节点，最终超时抛出错误。

而纯Java客户端没问题，是因为它不会在初始化阶段强制要求可写节点，只有当你执行写操作时才会去寻找主节点。

解决方案 #

这里提供两种可行的解决思路，你可以根据自己的场景选择：

方案1：调整连接URI与Spring配置 #

先从最简单的配置调整入手：

1. 关闭自动索引创建：如果你的Spring Boot应用开启了自动索引创建（部分版本默认开启），启动时会尝试创建索引——这是写操作，必须找主节点，所以会失败。在application.properties里添加：

   spring.data.mongodb.auto-index-creation=false
   

2. 优化MongoDB连接URI：在原有URI基础上添加几个关键参数，修改后的URI如下：

   spring.data.mongodb.uri=mongodb://10.9.9.71:27017,10.9.9.71:27018,10.9.9.71:27019/?readPreference=secondaryPreferred&serverSelectionTimeoutMS=5000&connectTimeoutMS=3000&retryWrites=false
   

   各参数作用：
   • retryWrites=false：禁用写操作重试（毕竟现在没有主节点，写操作本来就会失败，没必要重试）
   • serverSelectionTimeoutMS=5000：把服务器选择超时缩短到5秒（避免默认30秒的漫长等待）
   • connectTimeoutMS=3000：缩短单个节点的连接超时时间，加快失败检测

方案2：自定义MongoClient配置 #

如果方案1效果不理想，可以通过自定义配置类完全掌控MongoClient的行为：

import com.mongodb.ConnectionString;
import com.mongodb.MongoClientSettings;
import com.mongodb.ReadPreference;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;

@Configuration
public class MongoReadOnlyConfig extends AbstractMongoClientConfiguration {

    @Override
    protected String getDatabaseName() {
        return "your-db-name"; // 替换成你的实际数据库名称
    }

    @Override
    public MongoClient mongoClient() {
        ConnectionString connStr = new ConnectionString(
                "mongodb://10.9.9.71:27017,10.9.9.71:27018,10.9.9.71:27019/?serverSelectionTimeoutMS=5000&connectTimeoutMS=3000&retryWrites=false"
        );
        MongoClientSettings settings = MongoClientSettings.builder()
                .applyConnectionString(connStr)
                .readPreference(ReadPreference.secondaryPreferred()) // 明确指定读偏好
                .build();
        return MongoClients.create(settings);
    }
}

这种方式可以绕过Spring Boot的默认自动配置，直接按照你的需求构建MongoClient，确保读偏好被正确应用，同时避免不必要的写操作检查。

额外提醒 #

• 确保你的应用在这种只读场景下不会执行任何写操作（比如save、update、delete），否则即使连接成功，写操作依然会抛出错误。
• 可以根据你的集群网络情况，调整serverSelectionTimeoutMS和connectTimeoutMS的数值，找到最适合的超时时间。

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