Firestore批量请求随机耗时超10分钟问题排查求助

你的问题核心是Firebase Firestore的WriteBatch操作随机出现超长耗时（10+分钟），且添加await后出现全局Firebase请求阻塞，移除await也未解决问题。以下是具体的诊断方法和解决方案：

一、诊断方法 #

• 添加精细化耗时日志：在关键步骤前后记录时间戳，精准定位卡顿节点。比如：

  print('开始构建batch: ${DateTime.now()}');
  // 构建batch的代码
  final commitStart = DateTime.now();
  try {
    await batch.commit();
    print('Batch提交完成，耗时: ${DateTime.now().difference(commitStart).inMilliseconds}ms');
  } catch (e) {
    print('提交失败，耗时: ${DateTime.now().difference(commitStart).inMilliseconds}ms，错误: $e');
  }
  

  同时记录ChatsRecord.getDocumentOnce的耗时，确认卡顿出现在读取还是写入阶段。
• 检查Firebase控制台监控：进入Firestore的「性能」面板，查看读写请求的延迟分布、错误率，重点关注是否存在热点文档（比如你更新的chatDoc是否被大量用户同时读写）。
• 排查网络状态波动：即使同一网络环境，也可能存在临时丢包、DNS解析延迟等问题。可以在代码中监听Firestore的连接状态：

  FirebaseFirestore.instance.onAuthStateChanged.listen((state) {
    print('Firestore连接状态: $state');
  });
  

• 检查异步竞态问题：之前添加await导致全局请求阻塞，大概率是其他代码存在未处理的异步操作（比如其他Firebase请求未加await导致主线程阻塞），而非await batch.commit()本身的问题。

二、解决方案 #

1. 修复timestamp字段的错误传递 #

你的代码中timestamp: getCurrentTimestamp是错误的——如果getCurrentTimestamp是返回时间戳的函数，必须调用它（getCurrentTimestamp()），否则会将函数对象传入Firestore，导致序列化异常，进而引发随机延迟或失败。

2. 恢复await batch.commit()并优化UI状态更新 #

batch.commit()是异步操作，必须加await才能确保操作完成后再更新UI。之前出现的全局阻塞问题，建议排查其他模块的Firebase请求是否存在未处理的Future，或是否在主线程执行了大量同步操作。修改后的代码片段：

try {
  await batch.commit(); // 必须加await
  print('fin du batch');
  setState(() {
    accepterResaIsLoading = false;
    _model.lastSeenBy = [];
  });
} catch (e) {
  print('Erreur lors de l\'exécution du batch : $e');
  setState(() {
    accepterResaIsLoading = false; // 失败也要更新状态，避免加载态卡死
  });
}

3. 优化热点文档问题 #

如果chatDoc是热点文档（被频繁读写），会导致Firestore的并发冲突增加，延迟升高。可以考虑：

• 将聊天消息拆分到子集合，而非集中更新主文档；
• 减少对主文档的不必要更新（比如date_debut、date_fin如果未变化，无需重复写入）。

4. 添加重试机制与SDK更新 #

• 为batch提交添加重试逻辑，应对临时网络波动：

  int retryCount = 0;
  const maxRetries = 3;
  bool success = false;
  while (!success && retryCount < maxRetries) {
    try {
      await batch.commit();
      success = true;
    } catch (e) {
      retryCount++;
      await Future.delayed(Duration(seconds: retryCount * 2)); // 指数退避，避免频繁重试
    }
  }
  

• 更新Firebase SDK到最新版本，旧版本可能存在随机延迟的已知bug。

5. 检查自定义函数性能 #

排查createChatMessagesRecordData、fromCentimesToEuros等自定义函数，确保没有同步阻塞操作（比如大量计算、同步IO），这些操作会拖慢异步流程。

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