Cloud Firestore在release模式下无法正常读取数据

数据老陈

2026-8-28

问题根因

release模式下Cloud Firestore读写异常、debug模式功能正常，且无显性报错，通常由以下几个原因导致：

Android release构建默认开启R8/ProGuard代码压缩、混淆与优化，未配置Firebase SDK对应的防混淆规则时，SDK核心类会被混淆篡改，导致身份校验、网络请求逻辑静默失败，不会抛出常规警告或崩溃日志。debug模式默认关闭混淆，因此功能不受影响。
Firebase控制台仅登记了debug签名的SHA-1证书指纹，未添加release签名、Google Play应用签名对应的SHA-1，未登记证书的应用发起的请求会被Firebase服务端静默拦截。
当前配置的Firestore安全规则有效期仅到2022年7月19日，规则早已过期，所有未命中本地缓存的请求都会被服务端拒绝。debug环境可能因为本地缓存优先级较高，暂时表现为可正常读写；release包首次安装无本地缓存，会直接出现拉取失败的问题。
项目依赖的firebase_core: ^1.5.0、cloud_firestore: ^2.5.0属于2021年的早期版本，存在多个已知的release构建兼容缺陷。

修复方案

按以下顺序排查处理即可：

补全防混淆规则
在android/app/proguard-rules.pro文件中添加Firebase相关的混淆白名单配置：

-keep class com.google.firebase.** { *; }
-keep class com.google.android.gms.** { *; }
-dontwarn com.google.firebase.**
-dontwarn com.google.android.gms.**

打开android/app/build.gradle，确认release构建配置正确引用了规则文件：

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

补全所有签名证书的SHA-1
通过keytool命令获取release签名keystore对应的SHA-1值：

keytool -list -v -keystore 你的release签名文件路径.jks -alias 签名别名

将输出的SHA-1添加到Firebase控制台 -> 项目设置 -> 对应Android应用的SHA证书指纹列表中。如果应用上架Google Play并开启了Play应用签名，还需要将Google Play控制台提供的应用签名证书SHA-1一并添加。添加完成后重新下载最新的google-services.json配置文件，替换android/app目录下的旧文件。

修正安全规则配置
当前规则已过有效期，先临时调整规则验证功能：

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

确认release包可以正常读写数据后，再根据实际业务逻辑替换为正式的权限校验规则，禁止长期使用全量放开的规则，避免数据泄露风险。

升级依赖版本
将pubspec.yaml中的FlutterFire相关依赖升级到官方发布的稳定兼容版本，执行flutter pub get拉取依赖后，运行flutter clean清理构建缓存，重新打包release版本测试即可。

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