SpringBoot集成MongoDB遇MongoSocketReadTimeoutException问题求助

1. 先排查基础连通性与服务器状态 #

• 验证MongoDB服务可用性：使用mongosh直接连接目标MongoDB实例，确认能正常执行命令
• 检查网络连通性：在应用服务器上执行telnet <mongodb-host> 27017或nc -zv <mongodb-host> 27017，确认端口可访问
• 云MongoDB额外检查：如果是MongoDB Atlas等云服务，确认应用服务器IP已加入实例的IP白名单

2. 调整服务器监控相关超时参数 #

从栈跟踪看，超时发生在DefaultServerMonitor的心跳检测环节，Spring Boot默认的spring.data.mongodb.*配置可能未覆盖监控专属的超时项，需补充配置：
在application.properties中添加：

# 服务器心跳检测参数
spring.data.mongodb.heartbeat-frequency=10000          # 心跳间隔（毫秒）
spring.data.mongodb.min-heartbeat-frequency=5000       # 最小心跳间隔（毫秒）
spring.data.mongodb.heartbeat-connect-timeout=15000    # 心跳连接超时（毫秒）
spring.data.mongodb.heartbeat-socket-timeout=15000     # 心跳读超时（毫秒）

如果上述配置仍不生效，可通过自定义MongoClient配置类实现更细粒度控制：

import com.mongodb.ConnectionString;
import com.mongodb.MongoClientSettings;
import com.mongodb.ServerApi;
import com.mongodb.ServerApiVersion;
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 MongoCustomConfig extends AbstractMongoClientConfiguration {

    @Override
    protected String getDatabaseName() {
        return "your_database_name"; // 替换为实际数据库名
    }

    @Bean
    @Override
    public MongoClient mongoClient() {
        ConnectionString connectionString = new ConnectionString("mongodb://<host>:<port>/your_database_name"); // 替换为实际连接串
        MongoClientSettings settings = MongoClientSettings.builder()
                .applyConnectionString(connectionString)
                .serverApi(ServerApi.builder().version(ServerApiVersion.V1).build())
                // 配置服务器监控参数
                .applyToServerSettings(serverSettings -> serverSettings
                        .heartbeatFrequency(10000)
                        .minHeartbeatFrequency(5000)
                        .heartbeatConnectTimeout(15000)
                        .heartbeatSocketTimeout(15000))
                // 配置基础Socket参数
                .applyToSocketSettings(socketSettings -> socketSettings
                        .connectTimeout(10000)
                        .readTimeout(60000))
                // 配置连接池参数
                .applyToConnectionPoolSettings(poolSettings -> poolSettings
                        .maxWaitTime(120000))
                .build();
        return MongoClients.create(settings);
    }
}

3. 排查SSL/TLS相关问题 #

栈跟踪显示超时发生在SSL Socket读取环节，若MongoDB启用了SSL：

• 确认application.properties中已开启SSL：spring.data.mongodb.ssl=true
• 若使用自签名证书，需配置信任证书：

  spring.data.mongodb.ssl=true
  spring.data.mongodb.ssl-certificate-authority=classpath:ca-cert.pem # 替换为实际证书路径
  

4. 检查MongoDB服务器性能瓶颈 #

• 查看MongoDB实例日志，排查是否存在慢查询、连接数过载、磁盘IO过高或内存不足等问题
• 在MongoDB shell中执行db.serverStatus()，重点关注connections（连接数）、opcounters（操作统计）、diskStats（磁盘状态）等指标，确认服务器资源是否充足

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