上传Flutter构建的Android App Bundle至Play Console时提示无效ZIP文件

可能原因 #

• AAB文件损坏：构建过程被中断、磁盘空间不足、文件传输（复制/下载）时出错，导致AAB（本质为ZIP格式文件）结构损坏
• 缓存残留未清理彻底：仅执行flutter clean可能未清除Android Gradle的深层缓存，残留的损坏文件干扰新构建流程
• Google Play控制台临时故障：平台偶发的校验逻辑bug，导致误判合法的AAB文件
• 构建环境异常：构建时系统资源（内存/CPU）占用过高，导致生成的文件不完整

解决步骤 #

1. 验证AAB文件完整性
   用unzip命令检查文件是否能正常读取：

   unzip -t app-release.aab
   

   如果输出报错，说明文件已损坏，直接丢弃并重新构建。

2. 彻底清理缓存后重新构建

   • 手动删除Android端缓存目录：删除项目根目录下的android/.gradle和android/app/build文件夹
   • 执行Flutter清理命令：

     flutter clean
     

   • 重新构建AAB：

     flutter build appbundle --release
     

3. 优化构建环境

   • 确保磁盘剩余空间充足（至少预留10GB以上）
   • 构建时关闭后台占用大量资源的程序（如视频剪辑、大型游戏），避免构建过程被中断

4. 更换上传方式

   • 避免用浏览器拖拽上传，改用Google Play控制台的「文件选择」按钮上传
   • 或者使用Google Play命令行工具上传：

     gcloud app deploy app-release.aab
     

5. 临时等待后重试
   如果上述步骤都无效，大概率是Google Play控制台的临时问题，等待1-2小时后再尝试上传。

内容的提问来源于stack exchange，提问作者Stéphane de Luca