升级reactivemongo遇编译错误及PrimaryUnavailableException解决咨询

1. 解决升级ReactiveMongo后的编译错误 #

从0.12.5-play26升级到0.20.13-play26属于跨大版本升级，API存在较多不兼容变更，编译错误通常由代码调用方式、依赖冲突或环境兼容问题导致，可按以下步骤排查：

（1）修正API调用差异 #

0.12到0.20版本的核心API有不少变更，常见问题及修复方式：

• 集合操作方法调整：MongoCollection的find、insert、update等方法签名变更。例如原版本的collection.find(selector).one需改为collection.find(selector).one[T]（需显式指定返回类型）；插入操作从collection.insert(doc)改为collection.insert.one(doc)。
• JSON隐式转换更新：确保导入正确的Play JSON与BSON转换隐式类，替换旧的导入语句：

  import play.modules.reactivemongo.json._
  import play.modules.reactivemongo.json.collection._
  

• 包路径修正：部分类的包结构调整，若编译提示找不到类，对照ReactiveMongo 0.20官方文档修正导入路径。

（2）处理依赖冲突 #

执行sbt dependencyTree查看依赖树，确认是否有其他依赖引入了旧版本的ReactiveMongo核心库（如reactivemongo-core、reactivemongo-play-json）。若存在冲突，在build.sbt中排除旧版本依赖：

libraryDependencies += "org.reactivemongo" %% "play2-reactivemongo" % "0.20.13-play26" excludeAll (
  ExclusionRule("org.reactivemongo", "reactivemongo-core_2.11"),
  ExclusionRule("org.reactivemongo", "reactivemongo-play-json_2.11")
)

（3）升级Scala版本 #

你的项目使用scalaVersion := "2.11.7"，该版本较陈旧，ReactiveMongo 0.20.x对Scala 2.11的最佳支持版本为2.11.12（2.11系列最终稳定版）。建议将Scala版本升级至2.11.12，避免因语言特性兼容性导致的编译错误。

（4）清理缓存重新编译 #

执行sbt clean reload compile，确保清理旧的编译缓存并重新加载依赖。

2. 升级ReactiveMongo不是解决PrimaryUnavailableException的唯一方案 #

该异常表示客户端无法连接到MongoDB主节点，除升级版本外，还可从以下方向排查解决：

（1）检查MongoDB集群状态 #

• 确认MongoDB主节点正常运行，副本集状态健康（执行rs.status()查看）。
• 验证项目服务器与MongoDB节点的网络连通性：是否能ping通节点IP，默认端口27017是否开放，有无防火墙/安全组限制。

（2）调整连接配置 #

修改application.conf中的MongoDB连接参数：

• 确保mongodb.uri正确指定副本集名称（如mongodb://host1,host2/db?replicaSet=rs0）。
• 调整超时参数：增加connectTimeoutMS、socketTimeoutMS的值，避免因网络波动导致连接断开；设置合理的heartbeatFrequencyMS，提升主节点状态检测频率。

（3）分析前置错误日志 #

你提到异常出现前有大量错误，需重点排查：

• 是否存在认证失败（用户名密码错误）、权限不足问题？
• 是否有频繁的连接断开/重连日志？若有，可调整mongodb.pool.size（最大连接数）、maxIdleTimeMS等连接池参数。

（4）优化代码连接使用 #

• 确保MongoCollection实例为单例，避免频繁创建连接。
• 检查代码中是否存在未正确处理的连接异常，导致连接池耗尽。

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