如何使用sbt为Scala 3安装mongo-scala-driver并解决依赖下载报错

API 探路者

2026-10-4

问题根因

4.2.3版本的mongo-scala-driver未提供Scala 3的构建包，你在依赖声明中使用了sbt的%%语法，会自动给依赖包名追加当前Scala版本的后缀_3，因此sbt尝试下载不存在的org.mongodb.scala:mongo-scala-driver_3:4.2.3包，触发解析失败。

解决方案

方案一：升级驱动版本适配Scala 3
从4.5.0版本开始，mongo-scala-driver正式支持Scala 3，你可以直接升级依赖版本即可，修改build.sbt中的驱动依赖行为：
```
libraryDependencies += "org.mongodb.scala" %% "mongo-scala-driver" % "4.9.0"
```
4.9.0为当前官方稳定版本，兼容Scala 3.0.x及以上版本，无需修改其他配置。
方案二：降低Scala版本适配4.2.3驱动
如果你必须使用4.2.3版本的驱动，将Scala版本降级到2.12.x或2.13.x即可，修改build.sbt中的Scala版本配置：
```
scalaVersion := "2.13.8"
```
其余依赖配置保持不变即可正常解析。
方案三：Scala 3兼容Scala 2.13依赖（临时方案）
Scala 3支持直接调用Scala 2.13构建的类库，你可以手动指定依赖的Scala版本后缀，不使用%%自动匹配：
```
libraryDependencies += "org.mongodb.scala" % "mongo-scala-driver_2.13" % "4.2.3"
```
该方案为兼容过渡方案，可能存在隐式转换、API匹配等潜在问题，不建议长期使用。