Flutter应用release包lib与assets体积异常过大问题排查求助
问题排查与修复方案
一、assets目录35MB异常(实际仅500KB图片)
占比最大的诱因是你引入的google_ml_kit: ^0.3.0,该旧版本为全量聚合包,默认会将所有AI能力的内置模型全部打包进assets,哪怕你只用到其中一项功能,仅模型体积就可达30MB以上,完全匹配你当前的异常体积差。
辅助排查:
- 解压aab文件,直接查看
base/assets目录下的文件列表,可明确定位大文件来源 - 检查pubspec.yaml的assets配置规则,确认是否包含了隐藏文件、测试资源、编译缓存等非业务必要的文件
修复方案: - 弃用全量的google_ml_kit依赖,替换为你实际用到的拆分版单能力依赖,如文字识别仅引入
google_mlkit_text_recognition、条码扫描仅引入google_mlkit_barcode_scanning,单能力包的模型体积通常在1-5MB区间 - 若需保留旧版全量包,可在
android/app/build.gradle中添加资源过滤规则,排除未用到的模型文件
二、lib目录81MB异常
你统计的Dart AOT符号仅7MB,说明81MB中绝大多数为各架构的原生so库占用:Flutter默认打包release aab时会包含arm64-v8a、armeabi-v7a、x86、x86_64四类架构的so文件,仅libflutter.so单架构就约10MB,四类架构累加后基础体积就达40MB以上,叠加你引入的google_mobile_ads、mlkit、syncfusion等组件的原生so,体积很容易突破80MB。
修复方案:
- 若上架国内应用市场,可在
android/app/build.gradle的defaultConfig节点下添加abi过滤,仅保留移动端常用架构:
ndk { abiFilters "arm64-v8a", "armeabi-v7a" }
该操作可直接砍掉近一半的lib目录体积
- 若上架Google Play无需配置过滤,Google Play会根据用户设备架构分发对应版本,用户实际下载体积不会包含全量架构的so,仅本地全量aab包体积偏大属于正常情况
- 开启代码混淆与资源压缩,在
android/app/build.gradle的release构建配置中添加:
minifyEnabled true shrinkResources true proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
- 打包时执行
flutter clean清除缓存后,使用如下命令构建:
flutter build appbundle --obfuscate --split-debug-info=./debug_info
开启Dart代码混淆进一步缩减体积
附加优化项
- 检查syncfusion相关依赖,确认仅引入实际用到的组件,避免引入全量组件包
- 确认所有图片资源都已做压缩处理,无冗余多分辨率资源
内容的提问来源于stack exchange,提问作者Malay Agrawal
相关产品推荐
相关产品推荐

