Flutter应用打包APK运行正常但打包AppBundle上架Play Store后启动闪退

核心原因 #

AppBundle 默认开启代码裁剪、资源压缩功能，压缩规则比普通APK更严格，结合你的代码场景，常见触发原因如下：

• AndroidManifest.xml 未配置INTERNET权限：debug模式下Flutter会自动添加该权限，release模式默认不携带，webview加载远程页面缺少权限直接崩溃
• 未配置webview_flutter的混淆保留规则：R8压缩时会误删webview相关的类和方法，运行时找不到对应实现触发闪退
• minSdkVersion不符合依赖要求：webview_flutter 3.0及以上版本要求Android minSdkVersion >= 19，版本过低会出现兼容异常
• 打包命令拼写错误：正确的AAB打包命令关键词是appbundle，你提供的命令中appbuild为拼写错误，会导致生成的包文件异常
• 非空安全兼容问题：使用--no-sound-null-safety打包时，若存在不兼容非空安全的依赖，会触发运行时空类型异常

排查步骤 #

• 本地验证AAB包可用性：使用bundletool工具将AAB转为APKS安装到测试机复现问题，命令如下：
  生成APKS包：java -jar bundletool-all.jar build-apks --bundle=应用包路径.aab --output=输出路径/app.apks
  安装到设备：java -jar bundletool-all.jar install-apks --apks=app.apks
  安装后运行应用，用adb logcat抓取崩溃日志，定位具体报错点
• 检查Android基础配置：
  打开android/app/src/main/AndroidManifest.xml，确认标签下已添加网络权限：

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

  打开android/app/build.gradle，确认defaultConfig下的minSdkVersion >= 19
• 检查混淆配置：打开android/app/proguard-rules.pro，确认已添加webview_flutter的保留规则：

  -keep class io.flutter.plugins.webviewflutter.** { *; }
  

• 确认打包命令正确性：实际执行的打包命令应为flutter build appbundle --release --no-sound-null-safety，避免拼写错误导致包异常
• 验证依赖兼容性：执行flutter pub outdated检查所有依赖是否支持非空安全模式，排除依赖层面的运行时异常

解决方案 #

1. 按上述排查项补全缺失的权限、混淆规则，调整minSdkVersion到符合要求的版本
2. 使用正确的打包命令重新生成AAB包
3. 本地通过bundletool测试AAB包可正常运行后，再上传到Google Play Store

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