MongoDB Scala驱动：如何基于Case类实现文档变更字段的增量更新

报错根因 #

当前的updateOne调用完全不符合MongoDB Scala驱动的API规范：

• updateOne()的第二个入参必须是带MongoDB更新操作符的标准BSON文档，即顶层键需要是$set/$unset这类操作指令。你直接把自定义的UserConfig实例传入时，驱动会把对象的顶层字段（userId/personalGroup/accountGroup）解析为普通文档键，这类没有对应操作符的非法键，会直接触发Invalid BSON field name userId报错。
• 之前尝试的replaceOne本质是全量替换文档：传入对象中值为None的字段序列化后会被写为null，直接擦除Mongo中原本存储的同名字段，完全达不到增量更新的效果。

匹配需求的增量更新实现 #

核心逻辑：仅筛选出GraphQL请求中明确传入、非空的字段，拼入$set更新指令，完全不触碰未传入的字段，从根源上解决全量覆盖和字段报错的问题。
实现代码：

def update(userConfig: UserConfig) = {
  // 1. 复用已注册的Codec，把UserConfig序列化为原生BsonDocument，避免手动拼接嵌套字段
  val sourceBson = userConfig.toBsonDocument(
    classOf[UserConfig],
    collection.codecRegistry
  )
  // 2. 过滤掉序列化后值为null的字段（对应Scala侧None值，即未通过请求传入的字段）
  // 额外跳过作为查询条件的userId，避免无意义的冗余写入
  val effectiveUpdateFields = sourceBson.filter { case (fieldName, fieldValue) =>
    !fieldValue.isNull && fieldName != "userId"
  }
  // 3. 拼接为带标准$set结构的更新文档，符合驱动语法校验要求
  val updateOperation = new BsonDocument("$set", effectiveUpdateFields)
  // 4. 按userId匹配目标文档执行更新
  collection.updateOne(equal("userId", userConfig.userId), updateOperation).headOption()
}

关键实现说明 #

• 该方式对嵌套自定义对象（如personalGroup/accountGroup）天然兼容：现有Codec会自动完成嵌套结构的完整序列化，过滤操作只会移除顶层空值字段，不会破坏嵌套结构的完整性
• 如果需要支持"明确传入null清空指定字段"的场景，可将需要清空的字段单独拆分，拼入$unset操作符的更新结构，不要和$set逻辑混放，避免误删未传入的字段
• 不建议手动逐个调用Updates.set("xxx", 值)拼接更新文档，遇到多层嵌套结构时维护成本极高，复用现有Codec序列化的方式能大幅减少冗余代码

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