Spring Boot连接MongoDB Atlas报错：MongoSocketWriteException与SSLException

1. 网络与Atlas IP白名单校验 #

• 确认你的机器公网IP已加入MongoDB Atlas控制台的IP白名单（测试阶段可临时允许0.0.0.0/0，生产环境务必限制特定IP）
• 用telnet <集群节点地址> 27017测试端口连通性，排查防火墙、代理或VPN是否拦截了SSL连接
• 若使用公司内网，确认网络策略允许访问MongoDB Atlas的域名与端口

2. 修正application.properties配置 #

确保MongoDB配置符合Atlas要求，正确示例：

spring.data.mongodb.uri=mongodb+srv://<用户名>:<密码>@<集群名>.mongodb.net/<数据库名>?retryWrites=true&w=majority
spring.data.mongodb.database=<数据库名>

• 若密码包含@、$等特殊字符，必须做URL编码（比如$替换为%24）
• 必须使用mongodb+srv协议，不要用普通mongodb://（srv协议会自动处理集群节点与SSL配置）
• 不要手动设置spring.data.mongodb.ssl.enabled=false，Atlas强制要求SSL连接，默认开启即可

3. JDK SSL证书与版本问题 #

• 确保使用JDK 8u161及以上版本（该版本默认支持TLS 1.2，而Atlas要求TLS 1.2+）
• 若出现证书信任错误，手动导入Atlas根证书到JDK信任库：
  1. 从MongoDB Atlas官方文档获取对应根证书文件
  2. 执行命令：keytool -importcert -file <证书文件路径> -alias mongodb-atlas -keystore $JAVA_HOME/jre/lib/security/cacerts（默认密码为changeit）
• 也可通过JVM启动参数指定自定义信任库：-Djavax.net.ssl.trustStore=/path/to/your/cacerts

4. 依赖版本兼容性检查 #

• 依赖Spring Boot官方的依赖管理，避免手动指定spring-boot-starter-data-mongodb版本，确保与Spring Boot版本匹配
• 若使用响应式驱动spring-boot-starter-data-mongodb-reactive，升级Reactor Netty到最新稳定版，排查是否存在SSL连接的已知bug

5. 日志细节定位 #

从你的异常日志中聚焦SSLException的具体描述：

• 若提示unable to find valid certification path to requested target，直接按步骤3处理证书信任问题
• 若提示Broken pipe或Connection reset by peer，优先排查网络连通性与白名单配置

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