Flutter Firestore添加数据仅存本地缓存，未同步至云端问题求助

你作为Firebase新手，尝试通过Flutter+Riverpod将用户反馈存储到Firestore集合，代码如下：

import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

final feedbackProvider = Provider<FeedbackService>((ref) {
  return FeedbackService();
});

class FeedbackService {
  Future<void> submitFeedback(String name, String feedback) async {
    try {
      await FirebaseFirestore.instance.collection('feedback').add({
        'name': name,
        'feedback': feedback,
        'timestamp': FieldValue.serverTimestamp(),
      });
    } catch (e) {
      print("Error submitting feedback: $e");
    }
  }
}

问题在于FirebaseFirestore.instance.collection('feedback').add仅将数据写入本地缓存，未同步至云端，但同一应用内Firebase Storage可正常服务，说明项目关联无问题。以下是可能的原因及验证方向：

• 检查Firestore安全规则
  默认测试规则仅开放30天读写权限，若规则过期或配置错误会导致写入被拒。验证规则是否允许创建feedback文档，例如测试阶段可临时配置：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /feedback/{document} {
        allow create: if true; // 生产环境需替换为权限限制逻辑
      }
    }
  }
  

  可在Firebase控制台的Firestore规则页面，模拟当前用户的写入操作，确认是否被规则拦截。

• 验证网络与离线模式
  Firestore默认开启离线缓存，设备离线时写入仅存本地，联网后自动同步，但网络异常可能导致同步失败。

  • 手动禁用离线模式测试：FirebaseFirestore.instance.settings = const Settings(persistenceEnabled: false);，若此时写入报错，说明之前的离线缓存导致误判写入成功。
  • 添加同步状态监听：

    final docRef = FirebaseFirestore.instance.collection('feedback').doc();
    await docRef.set({
      'name': name,
      'feedback': feedback,
      'timestamp': FieldValue.serverTimestamp(),
    });
    docRef.snapshots().listen((snapshot) {
      print('文档同步状态: ${snapshot.metadata.hasPendingWrites}');
    });
    

    若hasPendingWrites持续为true，说明数据未同步至云端。

• 确认Firestore初始化与配置
  虽然Storage正常，仍需验证：

  • main函数中是否调用await Firebase.initializeApp();，确保Firestore基于正确项目配置初始化。
  • 检查Android的google-services.json或iOS的GoogleService-Info.plist是否与Firebase控制台当前项目的配置文件一致。

• 查看详细错误日志
  现有catch块仅打印基础错误信息，建议补充栈追踪：

  catch (e, stackTrace) {
    print("提交反馈错误: $e");
    print("错误栈: $stackTrace");
  }
  

  同时查看Firebase控制台的「日志」页面，搜索Firestore相关错误，排查是否存在权限拒绝、配额超限等提示。

• 检查Firestore配额使用
  免费版Firestore有每日写入次数限制，若配额超限会导致写入失败，数据仅存本地。可在Firebase控制台「使用情况」页面查看配额消耗状态。

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