Firestore SetOptions.mergeFields报错求助：字段掩码与输入数据不匹配

首先，这个错误的核心原因是：当你使用SetOptions.mergeFields(fieldsToUpdate)时，Firestore要求你指定的每一个字段必须存在于你传入的tempUser对象中（不能为null）。如果某个字段在tempUser里是null，Firestore会判定你没有提供该字段的数据，从而抛出Field 'XXX' is specified in your field mask but not in your input data的错误。

为什么会偶尔成功？ #

大概率是两种场景的差异导致：

• 当目标文档原本就存在friendRequests和friends字段时，document.toObject(User.class)会把这两个字段正确初始化为非null的集合（比如空列表或已有元素的列表），后续你的updateFriends和updateFriendRequests方法能正常修改它们，此时调用set时字段存在，操作成功。
• 当目标文档原本没有这两个字段时，tempUser里的friendRequests和friends会被初始化为null，而你的更新方法没有处理null的情况，导致这两个字段依然是null，触发Firestore的字段检查错误。

具体修复步骤 #

1. 确保User类的更新方法初始化空字段

检查你的updateFriends和updateFriendRequests方法，添加null判断逻辑，当字段为null时先初始化一个空集合再进行操作。比如：

假设User类中friendRequests是List<String>类型，修改updateFriendRequests方法：

public void updateFriendRequests(String email, int type) {
    // 先判断是否为null，是则初始化空列表
    if (this.friendRequests == null) {
        this.friendRequests = new ArrayList<>();
    }
    // 后续的添加/修改逻辑
    if (type == 2) {
        this.friendRequests.add(email);
    }
}

同样处理updateFriends方法，确保friends字段不会为null：

public void updateFriends(String userName, String userId, int type) {
    if (this.friends == null) {
        this.friends = new ArrayList<>();
    }
    // 你的业务逻辑代码
}

2. 验证字段映射的正确性

确保User类中的friendRequests和friends字段没有被@Exclude注解标记（否则Firestore会忽略这些字段），并且字段名和Firestore文档中的字段名完全一致（Firestore是大小写敏感的）。如果字段名不一致，可以用@PropertyName注解指定对应关系：

@PropertyName("friendRequests") // 确保和Firestore文档里的字段名完全匹配
private List<String> friendRequests;

3. 调试辅助建议

可以在调用set方法前，打印tempUser的目标字段值，快速确认是否是字段为null导致的问题：

Log.d("FirestoreDebug", "friendRequests: " + tempUser.getFriendRequests());
Log.d("FirestoreDebug", "friends: " + tempUser.getFriends());
// 然后再执行set操作
mCollRef.document(documentID).set(tempUser, SetOptions.mergeFields(fieldsToUpdate))

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