Flutter接入Firebase后调试版正常 release版本打开白屏问题求助

问题描述 #

项目使用 Firebase 拉取数据，调试版本运行时功能完全正常，可正常展示所有数据；构建 release 版本后打开应用直接白屏，初步定位问题出在 Book_Screen.dart 文件中。

项目仓库地址：https://github.com/jaydip-pawar/Hindi-Audio-Bible

运行效果对比 #

• 调试版本运行效果：
  
• release 版本运行效果：
  

排查与解决方法 #

1. 补全 Android 网络权限 #

调试版本默认自带网络权限，release 版本需要手动在 android/app/src/main/AndroidManifest.xml 中添加权限声明：

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

2. 配置混淆保留规则 #

release 构建默认开启代码混淆，容易误删 Firebase 相关类，需要在 android/app/proguard-rules.pro 文件中添加保留规则：

-keep class io.flutter.plugins.firebase.** { *; }
-keep class com.google.firebase.** { *; }
-keep class com.google.android.gms.** { *; }

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

buildTypes {
    release {
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        // 其余原有配置保持不变
    }
}

3. 补全异步异常处理逻辑 #

调试版本异步操作抛出异常只会打印日志，不会中断渲染；release 版本未捕获的异步异常会直接导致渲染终止。检查 Book_Screen.dart 中所有 Firebase 请求逻辑，用 try-catch 包裹异步代码，同时给 FutureBuilder/StreamBuilder 补充错误状态处理：

FutureBuilder(
  future: fetchFirebaseBookData(),
  builder: (context, snapshot) {
    if (snapshot.hasError) {
      return Center(child: Text('数据加载失败'));
    }
    if (snapshot.connectionState == ConnectionState.done) {
      // 原有数据渲染逻辑
    }
    return Center(child: CircularProgressIndicator());
  }
)

4. 本地调试定位具体报错 #

如果上述方案未解决问题，可临时开启 release 版本调试权限，连接设备查看具体报错信息：
在 android/app/build.gradle 的 release 配置中添加 debuggable true，打包后连接设备运行，执行 adb logcat 即可查看完整报错日志。

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