Firestore模拟器离线后CREATE操作变为UPDATE操作报错问题

问题原因 #

Firestore离线状态下执行的batch写入会被本地缓存暂存，恢复网络后客户端同步时，可能因本地缓存的状态判断偏差，将原本的CREATE操作误识别为UPDATE操作，触发了UPDATE的安全规则校验，导致权限拒绝。

解决方案 #

1. 显式声明SetOptions，明确操作行为

给batch中的set方法显式指定SetOptions(merge: false)，确保只有文档不存在时才执行创建，避免客户端因缓存状态误判操作类型：

final batch = _firestore.batch()
  ..set(_firestore.doc(docRef1), {
     // 你的数据字段
  }, SetOptions(merge: false))
  ..set(docRef2, {
    // 你的数据字段
  }, SetOptions(merge: false));

try {
  await batch.commit();
} catch (e, st) {
  debugPrint('Error: $e');
  debugPrint('Stack Trace: $st');
}

2. 调整Firestore安全规则，兼容误判场景

修改安全规则，允许对不存在的文档执行UPDATE操作，或者统一CREATE与UPDATE的权限校验逻辑：

match /your-collection/{docId} {
  allow create: if /* 原有的CREATE权限规则 */;
  // 当文档不存在时，允许UPDATE操作走CREATE的校验逻辑
  allow update: if !exists(resource) || /* 原有的UPDATE权限规则 */;
}

这样即使客户端误发UPDATE请求，只要目标文档实际不存在，就会通过权限校验。

3. 优化离线操作的缓存处理

可以在恢复网络后，主动调用_firestore.enableNetwork()（如果之前禁用过），或者通过监听网络状态，在网络恢复时触发一次缓存同步，减少客户端的状态判断误差。

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