Firebase Firestore模拟器数据可同步 真机数据仅本地存储不上传问题求助

1. 补全异步操作的await关键字 #

你当前sentMessage方法中的两个文档新增操作都是异步Future类型，未添加await关键字，方法会直接返回true，操作异常无法被捕获。模拟器执行速度快操作可正常完成，真机环境下可能因上下文提前释放导致云端请求未发出，仅写入了本地缓存。
修复代码如下：

Future<bool> sentMessage(Message message)async{
  try{
    final senderMessageRef = FirebaseFirestore.instance.collection('chats/${message.senderID}/messages');
    final receiverMessageRef = FirebaseFirestore.instance.collection('chats/${message.receiverID}/messages');
    // 新增await等待操作完成
    await senderMessageRef.add(message.toJson());
    await receiverMessageRef.add(message.toJson());
    return true;
  }catch(e){
    log.e(e.toString());
    return false;
  }
}

2. 校验Firestore安全规则 #

Firebase默认的测试模式安全规则仅有30天有效期，到期后会禁止所有未授权的读写请求，模拟器调试时通常在有效期内，真机部署时可能已过期。你可以先将规则临时改为全开放验证问题：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

验证同步正常后再根据你的业务逻辑补充身份校验、权限控制规则即可。

3. 检查真机网络权限与环境 #

• 确认AndroidManifest.xml中已添加必要的网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

• 确认真机未使用代理、VPN，防火墙未拦截Firebase相关请求，可切换WiFi/移动数据交叉测试。

4. 验证离线持久化配置 #

你的问题表现完全符合开启离线持久化但云端同步失败的特征，可在初始化Firebase时临时禁用离线持久化验证：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 禁用本地离线持久化
  FirebaseFirestore.instance.settings = Settings(
    persistenceEnabled: false,
  );
  runApp(const MyApp());
}

如果禁用后真机发送消息本地也无法查询到，即可确认是同步链路故障，可添加网络状态监听排查具体错误：

FirebaseFirestore.instance.enableNetwork().catchError((e) {
  print("Firestore网络连接错误: $e");
});

5. 核对Firebase项目配置 #

确认你打包使用的google-services.json是从对应Firebase项目下载的，应用包名、签名SHA1和Firebase控制台配置完全一致，若开启了Google Play应用签名，还需要将Play后台生成的签名SHA1补充到Firebase控制台中。

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