Flutter应用首次启动无法从Firebase Firestore获取数据

针对发布版首次启动无法获取Firestore数据、第二次恢复正常的问题，可从以下几个方向排查：

1. 核对Firebase发布版配置 #

• Android端：确认google-services.json已正确放置在app/根目录，且Firebase控制台项目设置中已添加发布版签名的SHA-1/SHA-256指纹。发布版与调试版签名指纹不同，未配置会导致Firebase初始化失败，首次启动无法连接云端。
• iOS端：确认GoogleService-Info.plist已添加到Xcode的发布目标中，且Bundle ID与Firebase控制台配置完全一致。

2. 强制Firestore从云端获取数据 #

Firestore默认启用离线持久化，首次启动时本地缓存为空，get()方法默认优先读取本地缓存，此时云端数据尚未同步到本地，会返回空结果。可修改代码强制从服务器拉取：

var querySnapshot = await firebaseFirestore
    .collection('users')
    .where('phone', isEqualTo: phone)
    .where('country', isEqualTo: countryCode)
    .get(const GetOptions(source: Source.server)); // 指定从服务器获取

同时可在App启动阶段提前触发Firestore同步：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 初始化Firestore并触发一次轻量同步
  await FirebaseFirestore.instance.enablePersistence();
  await FirebaseFirestore.instance.collection('users').limit(1).get();
  runApp(const MyApp());
}

3. 修复错误处理逻辑 #

当前代码在catch块中同时返回Future.error(e)和状态map，逻辑冲突会导致首次启动的错误被隐藏，无法定位问题。统一错误处理逻辑：

try {
  FirebaseFirestore firebaseFirestore = FirebaseFirestore.instance;
  var querySnapshot = await firebaseFirestore
      .collection('users')
      .where('phone', isEqualTo: phone)
      .where('country', isEqualTo: countryCode)
      .get(const GetOptions(source: Source.server));
  var queryDocsSnap = querySnapshot.docs;
  status = queryDocsSnap.isNotEmpty ? 1 : 0;
} catch (e) {
  status = -1;
  error = e.toString();
  // 选择一种返回方式：要么返回状态map，要么抛出错误
  return {'status': status, 'error': error};
  // 若需抛出错误，注释上方返回语句，启用下方代码
  // throw Exception(error);
}

调用方需打印返回的error字段，确认首次启动时是否有连接异常或权限错误。

4. 配置Android混淆规则 #

R8/ProGuard混淆可能破坏Firebase核心类，导致首次初始化失败。在app/proguard-rules.pro中添加以下规则：

# Firebase Firestore 保护规则
-keep class com.google.firebase.firestore.** { *; }
-keep class com.google.firebase.** { *; }
-keep class com.google.android.gms.** { *; }
-dontwarn com.google.firebase.firestore.**

同时确保build.gradle中发布版混淆配置正确：

buildTypes {
    release {
        minifyEnabled true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

5. 确认网络权限配置 #

• Android：在AndroidManifest.xml中添加必要权限：

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

• iOS：在Info.plist中配置网络访问权限（若使用ATS，可针对Firebase域名配置，或临时允许任意加载排查问题）：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

内容的提问来源于stack exchange，提问作者I am I.A.S