Flutter调试模式正常显示云存储图片 release打包APK不显示问题排查

1. 配置Android网络权限（最高概率解决） #

Flutter调试模式默认在debug清单文件中自带INTERNET权限，release包需要手动在主清单文件中配置：

• 打开android/app/src/main/AndroidManifest.xml
• 在<manifest>标签下、<application>标签外添加如下权限声明：

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

配置完成后重新打包即可。

2. 添加错误回调定位问题 #

如果配置权限后仍无法显示，给Image.network添加错误回调打印具体报错信息：

Image.network(
  snap.data!,
  fit: BoxFit.cover,
  errorBuilder: (context, error, stackTrace) {
    print("图片加载错误：$error");
    return Center(child: Text("加载失败：$error"));
  },
)

可以在release包安装后通过flutter logs命令查看具体报错内容，进一步定位问题。

3. 检查混淆规则 #

如果启用了代码混淆，需要在android/app/proguard-rules.pro中添加Firebase相关的保留规则，避免类被混淆后无法正常获取下载链接：

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

4. 优化布局结构 #

当前代码存在多层Expanded嵌套的问题，AlertDialog的content无需包裹Expanded，不合理的布局结构可能在release模式下导致组件尺寸计算异常，图片无法正常渲染，可参考如下优化后的代码：

Future showimage() async {
  return showDialog(
    context: context,
    builder: (BuildContext context) {
      return AlertDialog(
        content: SizedBox(
          width: MediaQuery.of(context).size.width * 0.9,
          height: MediaQuery.of(context).size.height * 0.8,
          child: FutureBuilder<String>(
            future: storage.downloadedUrl('${dropdownmonth}${dropdowndate}', '${dropdownmonth}${dropdowndate}Record'),
            builder: (BuildContext context, AsyncSnapshot<String> snap) {
              if (snap.connectionState == ConnectionState.waiting) {
                return const Center(child: CircularProgressIndicator());
              }
              if (snap.hasData) {
                return Image.network(
                  snap.data!,
                  fit: BoxFit.cover,
                  errorBuilder: (context, error, stackTrace) {
                    return const Center(child: Text("图片加载失败"));
                  },
                );
              }
              return const Center(child: Text("No Report Found"));
            },
          ),
        )
      );
    });
}

内容的提问来源于stack exchange，提问作者Syed Ahmed Usman