运行flutter build apk --release出现minifyReleaseWithProguard错误如何解决

根因说明 #

这个报错仅在Release模式触发、Debug/Profile模式正常的核心原因是：Release构建默认开启Proguard代码混淆和资源压缩流程，Proguard在扫描全量依赖的类引用时检测到了类缺失、版本不兼容等问题，抛出警告直接阻断了构建流程；而Debug/Profile模式默认关闭混淆压缩，不会触发该校验。

具体解决步骤 #

步骤1：定位具体错误原因 #

首先需要拿到Proguard输出的具体警告信息，才能精准定位问题：

• 运行带详细日志的打包命令：flutter build apk --release -v
• 过滤日志中WARNING级别的Proguard输出，即可看到是哪个依赖库、哪类引用出了问题。

步骤2：调整CompileSdkVersion操作方法 #

如果日志提示是依赖的原生Android SDK版本不兼容，按以下操作调整：

• 打开项目中android/app/build.gradle文件（注意不要选到Android根目录的build.gradle）
• 找到android代码块下的compileSdkVersion配置项，版本号可以直接升级到33或34，目前主流Flutter插件均已适配这两个版本，不会出现兼容问题
• 同步将同文件下的targetSdkVersion调整为和compileSdkVersion相同的数值，避免后续运行时兼容问题
• 执行flutter clean清理项目缓存后，重新执行Release打包命令测试

步骤3：添加混淆规则（调整版本后仍报错时使用） #

如果调整版本后问题仍存在，说明是对应依赖缺少混淆规则：

• 临时验证方案：在项目的android/app/proguard-rules.pro文件中添加-ignorewarnings配置，跳过Proguard的警告阻断，先验证打包是否能正常完成，注意该方案仅作验证用，不要线上使用，可能会导致运行时闪退
• 正式解决方案：根据步骤1拿到的具体警告内容，找到对应依赖的官方文档，将官方给出的Proguard混淆规则复制到你的proguard-rules.pro文件中即可。

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