Flutter Android正式版APK Firestore读写失效但Storage功能正常如何解决

1. 检查ProGuard/R8混淆配置 #

Android release打包默认会开启代码混淆，若未配置Firestore相关的保留规则，Firestore核心类会被混淆导致读写逻辑失效，Storage未受影响大概率是其依赖的混淆规则已被其他配置默认引入。
解决方法：

• 打开android/app/proguard-rules.pro文件，添加以下规则：

# 保留Firestore相关类
-keep class com.google.firebase.firestore.** { *; }
-keepclassmembers class com.google.firebase.firestore.** { *; }
# 保留Firestore自定义实体类（用于序列化/反序列化的业务模型类）
-keep class 你的实体类包名.** { *; }

• 确认android/app/build.gradle中release构建配置已关联混淆规则文件：

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

2. 检查App Check配置 #

若你在Firebase控制台开启了Firestore的App Check强制验证，但未为Android release版本配置App Check的证明提供者（如Play Integrity、SafetyNet），Firestore的请求会被直接拒绝，而Storage如果未开启App Check强制验证就可以正常访问。
解决方法：

• 暂时关闭Firestore的App Check强制验证，测试功能是否恢复正常
• 若需保留App Check，按要求配置release版本的App Check证明信息即可

3. 检查release签名的SHA-1配置 #

如果Firebase控制台仅配置了debug签名的SHA-1，未添加release签名的SHA-1/SHA-256，部分Firebase服务访问会受限。你可以将release签名的哈希信息添加到Firebase控制台的Android应用配置中，重新下载google-services.json放到项目android/app目录后重新打包测试。

4. 开启release模式日志定位问题 #

如果以上步骤都无法定位问题，可以暂时在release构建中开启调试选项，运行flutter run --release后查看控制台的具体报错信息，根据错误码精准定位问题：
在android/app/build.gradle的release配置中添加：

debuggable true

运行后即可看到Firestore返回的具体错误信息，如权限拒绝、服务不可用等明确原因。

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