升级play-reactivemongo驱动后连接MongoDB 6报isMaster请求失败

核心原因 #

MongoDB 6.0 对安全协议和认证机制的要求比 MongoDB 4.x 更严格，同时 reactivemongo 1.x 版本在 SSL 配置、依赖组件（如 Netty）上和 0.16.x 版本存在较大差异，导致原连接字符串的参数和默认配置无法适配新环境。

具体解决步骤 #

1. 强制指定 TLS 版本
   MongoDB 6.0 默认要求使用 TLS 1.2 及以上版本，旧连接字符串未明确指定可能导致 SSL 握手失败。在连接字符串中添加：

&sslEnabledProtocols=TLSv1.2

2. 更新认证机制
   MongoDB 6.0 推荐使用 SCRAM-SHA-256 认证机制，原 scram-sha1 可能被服务器限制。修改连接字符串中的对应参数：

&authenticationMechanism=SCRAM-SHA-256

注意：需确保 MongoDB 用户已配置支持该认证机制，可通过 MongoDB 客户端执行 db.getUser("<username>") 查看 mechanisms 字段。

3. 简化适配 reactivemongo 1.x 的连接参数
   旧版本的 rm.* 参数在 1.x 版本中部分已废弃或行为变更，建议先简化连接字符串，保留核心参数后再逐步恢复必要配置：
   简化后的示例连接字符串：

mongodb+srv://<user>:<password>@general.foba0.mongodb.net/envoy4?ssl=true&authenticationDatabase=admin&authenticationMechanism=SCRAM-SHA-256&readPreference=primaryPreferred&sslEnabledProtocols=TLSv1.2&heartbeatFrequencyMS=5000

4. 解决 Netty 依赖冲突
   reactivemongo 1.x 使用的 Netty 版本与 Play 2.7 默认依赖的 Netty 可能存在冲突，导致 SSL 引擎异常。在 build.sbt 中排除 Play 自带的 Netty 依赖，强制使用 reactivemongo 提供的版本：

libraryDependencies += "org.reactivemongo" %% "play2-reactivemongo" % "1.1.0-play27-RC6" exclude ("io.netty", "netty-all") exclude ("io.netty", "netty-handler")

5. 显式配置 SSL 上下文
   如果上述步骤仍未解决，可在 Play 的 application.conf 中显式配置 SSL 上下文：

mongodb {
  uri = "mongodb+srv://<user>:<password>@general.foba0.mongodb.net/envoy4?ssl=true&..."
  ssl {
    enabled = true
    protocols = ["TLSv1.2"]
    context = {
      provider = "JDK"
    }
  }
}

排查建议 #

• 查看 MongoDB 服务器日志，确认是否有拒绝连接的具体原因（如认证失败、协议版本不支持）。
• 尝试用 MongoDB Compass 或 mongo shell 使用相同的连接参数连接服务器，验证连接字符串本身的有效性。

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