Scala升级Mongo驱动：Map类型嵌套字段构建Document失败问题

我非常理解你升级驱动后的困惑——从Casbah转到官方的mongo-scala-driver确实会遇到不少API设计上的差异，尤其是类型安全方面的收紧。咱们来一步步拆解这个问题：

核心原因 #

官方的Document类对传入的映射有两个关键限制，这也是和Casbah的主要区别：

1. MongoDB的字段名必须是字符串：驱动不允许直接用非String类型（比如Int）作为嵌套Document的键，因为MongoDB本身不支持非字符串的字段名。
2. 值需要明确的BsonValue隐式转换：Map[String, Any]里的Any类型太宽泛，驱动无法自动推断所有可能的类型对应的BsonValue转换（毕竟Any可能包含驱动无法序列化的对象），所以编译时会报错。

而Casbah的API相对宽松，会自动帮你做这些转换（比如把Int键转成String，对Any类型做更多隐式推断），但官方驱动为了避免潜在的运行时错误，选择了更严格的类型检查。

针对不同Map类型的解决方法 #

1. 处理Map[Int, Int]：把键转为String #

既然MongoDB要求字段名是字符串，我们只需要把Int类型的键手动转换成String即可：

val usersPerTime = Map(180 -> 23, 68 -> 34)
// 转换键为String类型
val convertedMap = usersPerTime.map { case (key, value) => key.toString -> value }
// 现在可以正常创建Document
val doc = Document("page_id" -> pageId, "users_per_time" -> Document(convertedMap))

2. 处理Map[String, Any]：明确转换每个值为BsonValue #

因为Any类型无法被驱动自动转换，我们需要手动处理每个值的类型，确保它们能被转换成对应的BsonValue子类（比如BsonInt32、BsonString等）。这里有两种常用方式：

方式一：映射转换每个键值对

val usersConf = Map("age" -> 32, "country" -> "Spain")
val convertedConf = usersConf.map {
  case (k, v: Int) => k -> BsonInt32(v)
  case (k, v: String) => k -> BsonString(v)
  // 根据你的业务需求，添加更多类型的处理，比如Boolean、Double等
  case (k, v: Boolean) => k -> BsonBoolean(v)
}
val doc = Document("user_id" -> userId, "user_conf" -> Document(convertedConf))

方式二：使用Document Builder模式

如果你的Map里类型较多，用Builder模式会更灵活：

val usersConf = Map("age" -> 32, "country" -> "Spain")
val confBuilder = Document.newBuilder
usersConf.foreach {
  case (k, v: Int) => confBuilder += k -> v
  case (k, v: String) => confBuilder += k -> v
  case (k, v: Double) => confBuilder += k -> v
  // 其他类型同理
}
val doc = Document("user_id" -> userId, "user_conf" -> confBuilder.result())

额外提示 #

如果你的业务中经常需要处理这类异构Map，可以封装一个工具函数来自动处理常见类型的转换，减少重复代码。比如：

object BsonUtils {
  def mapToDocument(map: Map[String, Any]): Document = {
    val builder = Document.newBuilder
    map.foreach {
      case (k, v: Int) => builder += k -> v
      case (k, v: String) => builder += k -> v
      case (k, v: Boolean) => builder += k -> v
      case (k, v: Double) => builder += k -> v
      case (k, v: Map[String, Any]) => builder += k -> mapToDocument(v)
      // 支持嵌套Map的情况
    }
    builder.result()
  }
}

之后直接调用BsonUtils.mapToDocument(usersConf)就能快速转换成Document了。

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