MongoDB切换HTTPS后Java应用报MongoSocketReadException问题排查

根据你描述的情况（终端和MongoDB Compass可正常连接，但Java应用报MongoSocketReadException: Prematurely reached end of stream），以下是常见原因及对应解决办法：

1. 证书路径或权限问题 #

• 原因：Java应用运行时的工作目录与终端不同，使用相对路径会导致证书文件找不到；或者Java进程没有读取证书文件的权限。
• 解决：
  • 连接字符串中使用绝对路径指定tlsCAFile和tlsCertificateKeyFile，避免相对路径带来的问题；
  • 检查证书文件（/path/mongodb.pem）的权限，确保Java进程运行用户拥有读取权限，可执行命令：chmod 644 /path/mongodb.pem。

2. MongoDB Java驱动版本兼容性问题 #

• 原因：旧版本的MongoDB Java驱动对TLS相关参数（如tlsCAFile、tlsCertificateKeyFile）支持不完善，或与Spring Data MongoDB版本不兼容。
• 解决：
  • 升级MongoDB Java驱动至4.x及以上的稳定版本；
  • 若使用Spring Boot，确保spring-boot-starter-data-mongodb的版本与MongoDB驱动版本匹配。

3. TLS版本不匹配 #

• 原因：MongoDB服务端启用的TLS版本与Java客户端默认使用的TLS版本不兼容，导致握手失败。
• 解决：
  • 在Java应用启动参数中指定兼容的TLS版本，例如添加：-Djdk.tls.client.protocols=TLSv1.2；
  • 在连接字符串中显式指定TLS版本，添加参数：&tlsVersion=TLS1_2；
  • 检查MongoDB服务端配置，确保tlsDisabledProtocols未禁用客户端支持的版本（可在mongod.conf中调整）。

4. 连接字符串参数错误 #

• 原因：旧版本驱动使用ssl前缀的参数（如sslCAFile、sslCertificateKeyFile），而非tls前缀，导致参数不生效；或参数设置冲突。
• 解决：
  • 若使用旧版驱动（3.x及以下），将连接字符串中的tlsCAFile改为sslCAFile，tlsCertificateKeyFile改为sslCertificateKeyFile；
  • 若你的mongodb.pem文件同时包含客户端证书、私钥和CA证书，可尝试只保留tlsCertificateKeyFile参数，避免重复配置。

5. mongod.conf配置缩进错误 #

• 原因：YAML格式对缩进敏感，你提供的mongod.conf中bindIp和tls的缩进层级错误（与port同级而非net的子节点），可能导致MongoDB未正确加载TLS配置。
• 解决：调整mongod.conf的缩进，确保net节点的子元素层级正确：

  net:
    port: 27017
    bindIp: <required host names>
    tls:
      mode: requireTLS
      certificateKeyFile: /path/mongodb.pem
      CAFile: /path/mongodb.pem
  
  security:
    authorization: "enabled"
  

6. Java主机名验证严格性问题 #

• 原因：Java默认严格验证证书中的主机名（CN或SAN字段），若连接使用的<host_name>与证书中记录的不一致，会导致握手失败。
• 解决：
  • 检查证书的SAN或CN字段，确保包含你连接时使用的主机名/IP；
  • 若测试环境需要临时跳过验证（生产环境不建议），可在连接字符串添加参数：&tlsAllowInvalidHostnames=true。

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