Firebase V9测试环境下Firestore无法获取数据问题求助

针对你遇到的debug构建下Firestore提示客户端离线、无法获取数据，但release构建完全正常的问题，以下是针对性的排查和解决步骤：

1. 禁用Firestore离线持久化（debug模式专属） #

debug模式下，离线持久化可能因缓存冲突或初始化异常导致连接失败。修改firebase.js的Firestore初始化逻辑：

import { initializeApp } from "firebase/app"; 
import { initializeFirestore } from "firebase/firestore"; // 替换原getFirestore方法

const firebaseConfig = {
    // 你的Firebase配置信息
};

const app = initializeApp(firebaseConfig);
// 禁用离线持久化
const db = initializeFirestore(app, {
  persistence: false
});

export default db;

2. 检查debug构建的网络权限配置 #

Android平台下，debug构建可能存在网络访问限制：

• 打开android/app/src/main/AndroidManifest.xml，确保application标签包含：

  <application
      ...
      android:usesCleartextTraffic="true"> <!-- 部分代理环境下HTTPS请求也需要该配置 -->
  

• 确认测试设备/模拟器未开启异常代理，或代理能正常访问Firebase服务。

3. 统一debug与release的Firebase配置 #

检查是否debug和release构建使用了不同的google-services.json：

• 确保android/app目录下，debug、release子文件夹（若存在）中的google-services.json与Firebase项目配置一致，或直接将正确配置放在app/根目录，让构建自动复用。

4. 为debug构建添加Firebase ProGuard规则 #

release构建通常配置了正确的ProGuard规则保留Firebase SDK代码，但debug构建可能因未配置导致核心类被误优化：

• 在android/app/proguard-rules.pro中添加Firebase通用规则：

  # Firebase Firestore 核心类保护
  -keep class com.google.firebase.** { *; }
  -keep class com.google.android.gms.** { *; }
  -keepnames class com.google.firebase.** { *; }
  -keepnames class com.google.android.gms.** { *; }
  

• 确保debug构建的build.gradle启用minify并加载规则：

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

5. 升级Firebase SDK版本 #

你当前使用的Firestore 9.17.2版本存在部分debug模式下的连接已知问题，尝试升级到最新稳定版：

• 修改package.json中的Firebase依赖：

  "dependencies": {
      "firebase": "^9.23.0" // 替换为最新稳定版
  }
  

• 执行npm install更新依赖后重新构建debug版本。

6. 验证Firebase项目的应用签名配置 #

若release构建使用了自定义签名证书，debug构建的默认签名可能未添加到Firebase项目，导致权限验证失败：

• 通过./gradlew signingReport命令获取debug签名的SHA-1指纹，在Firebase控制台项目设置的「应用」部分添加该指纹。

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