使用POJO调用Firestore SetOptions.mergeFields()未按预期工作

嘿，首先明确说结论：这绝对不是Firestore的设计预期。SetOptions.mergeFields()的核心作用就是只更新你指定的字段，完全保留文档里其他字段的原有值，根本不会把未指定的字段覆盖成null。

为什么你会碰到这个问题？ #

看你的代码片段：

UserModel userModel = new UserModel();
userModel.setStatus(0);
setTask = documentReferenceToUse.set(userModel, SetOptions.mergeFields("status"));

你只给status设了值，其他字段在UserModel实例里是默认值（引用类型是null，基本类型是对应默认值）。但按Firestore的规则，用mergeFields()时，它只会处理你指定的字段，其他字段连碰都不会碰。那出现这种异常情况，大概率是这几个原因：

1. 你的UserModel序列化出问题了 #

• 检查下UserModel里的未指定字段，是不是有错误的getter/setter，或者被标记了强制序列化的注解（比如Gson的@Expose），导致Firestore错误地把这些null值读进去并写入了。
• 如果有自定义的序列化逻辑，看看是不是不小心把null值强制输出了。

2. 搞混了merge()和mergeFields() #

• 要是你不小心用了SetOptions.merge()而不是mergeFields()，那Firestore会合并POJO里所有非null的字段——反过来，POJO里为null的字段就会覆盖文档里的原有值。赶紧确认下你调用的是不是mergeFields("status")。

3. 文档里的字段本来就是null？ #

• 先查一下更新前的文档状态，说不定那些“被改成null”的字段本来就是null，只是你误以为它们有值而已。

怎么解决？ #

给你几个靠谱的方案：

1. 改用Map更新，更直观可控
   不想纠结POJO的序列化问题的话，直接用Map来传递要更新的字段，完全不会涉及其他字段：

   Map<String, Object> updates = new HashMap<>();
   updates.put("status", 0);
   documentReferenceToUse.set(updates, SetOptions.mergeFields("status"));
   

   这种方式绝对不会出现意外覆盖的情况。

2. 修正UserModel的序列化配置
   要是坚持用POJO，就得确保Firestore只处理你指定的字段：

   • 用Firestore默认序列化的话，给不需要序列化的字段加@Ignore注解，或者删掉它们的getter方法。
   • 用Gson的话，把Gson实例配置成serializeNulls = false，并且给不需要序列化的字段去掉@Expose注解。

3. 核对字段名是否完全匹配
   Firestore的字段名是大小写敏感的，确认mergeFields("status")里的字段名和文档里的完全一致，要是名字不对，指定的字段不会被更新，但也不该导致其他字段变null——不过排查的时候还是要确认下。

最后再强调下 #

SetOptions.mergeFields()的预期行为就是只更新你指定的字段，其他字段原封不动，你碰到的情况是异常的，从序列化配置和方法调用这两个方向排查，应该很快能解决。

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