如何调试Flutter Android Bundle？解决发布后非首次运行异常

一、先排查Bundle资源打包是否正常 #

• 核对pubspec.yaml的资源配置：确保图片路径和实际文件结构一致，flutter: assets:下的条目没有遗漏，比如如果图片在assets/icons/下，要写- assets/icons/或者具体文件名。
• 执行flutter build appbundle --verbose，盯着打包日志里的资源处理环节，看有没有图片没被打包的警告，或者路径错误的提示。
• 用bundletool拆解Bundle验证资源：

  # 把Bundle转成APKS文件
  bundletool build-apks --bundle=build/app/outputs/bundle/release/app-release.aab --output=app.apks
  # 提取APKS里的APK文件
  bundletool extract-apks --apks=app.apks --output=extracted_apks
  

  打开提取出的base.apk，查看assets文件夹，确认所有图片都在里面。

二、调试发布后的Bundle应用 #

1. 给Release包开启调试权限 #

修改android/app/build.gradle的release配置，保留调试符号并允许调试：

buildTypes {
    release {
        signingConfig signingConfigs.release
        debuggable true // 开启调试功能
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

注意：用正式签名密钥打包，别用调试密钥，不然Google Play不让发布。

2. 连接设备调试发布版 #

• 用bundletool把Bundle安装到测试设备：bundletool install-apks --apks=app.apks
• 打开VS Code的调试面板，选Flutter: Attach to running device，找到对应的设备，就能断点调试发布版应用了。
• 模拟首次运行后的场景（比如重启应用），跟踪图片加载的代码，看是资源找不到，还是缓存逻辑出问题。

三、排查图片加载的缓存与权限问题 #

• 检查图片加载逻辑：如果用了缓存类插件（比如cached_network_image），看看是不是缓存目录有读写权限问题，或者缓存过期逻辑写错了。
• 确认应用权限：本地图片需要存储读写权限，网络图片需要网络权限，去设备的应用设置里核对。
• 加错误日志排查：在图片加载代码里加errorBuilder打印错误信息：

Image.asset(
  'assets/images/avatar.png',
  errorBuilder: (context, error, stackTrace) {
    print('图片加载失败: $error');
    return const Icon(Icons.error);
  },
)

然后用adb logcat -s Flutter查看日志，定位具体错误。

四、排查Google Play签名的影响 #

• 如果用了Google Play应用签名，去封闭测试页面下载发布后的APK，用bundletool拆解后对比本地生成的Bundle资源，看有没有差异。
• 确认Google Play没有篡改你的资源文件，比如有没有开启不必要的资源压缩。

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