Firestore模拟器写入失败后读取缓存更新值的问题求助

问题原因 #

这不是模拟器的Bug，是Firestore客户端SDK的乐观更新机制导致的：客户端会先在本地缓存中应用写入操作，再向服务器发起请求，哪怕服务器因安全规则拒绝写入，客户端并不会自动回滚本地的乐观更新值。哪怕你用Source.server强制读服务器，SDK仍可能优先返回带有未提交修改的本地镜像（此时hasPendingWrites为true）。

实用解决办法 #

1. 捕获写入异常后强制刷新缓存 #

当写入触发permission-denied异常时，主动用服务器数据覆盖本地缓存：

try {
  await _firestore.doc(PathService.boosts(uid)).update({
    'boosting': true,
    'boosts': FieldValue.increment(-1),
    'endedAt': Timestamp.fromDate(DateTime.now().add(const Duration(hours: 1))),
    'ttl': Timestamp.fromDate(DateTime.now().add(const Duration(days: 7 * 365))),
  });
} on FirebaseException catch (e) {
  if (e.code == 'permission-denied') {
    // 用服务器最新数据刷新本地缓存
    await _firestore.doc(PathService.boosts(uid)).get(const GetOptions(source: Source.serverAndCache));
  }
  rethrow; // 继续抛出异常给上层处理
}

之后再执行读取操作，就能拿到服务器的真实数据了。

2. 检查SDK与模拟器版本兼容性 #

确保你的Flutter Firebase SDK版本和Firebase CLI（模拟器）版本完全匹配，版本不兼容可能会导致这类客户端与模拟器的行为差异被放大。

关键细节 #

• hasPendingWrites: true意味着客户端认为该文档还有未完成的写入任务，哪怕服务器已经拒绝，SDK不会自动清理这个状态，必须手动干预。
• Source.server并非完全绕过本地缓存——如果客户端存在未提交的写入，SDK会返回“服务器数据+本地未提交修改”的合并结果，这是Firestore客户端的设计逻辑。

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