Flutter构建android项目报Gradle assembleDebug任务失败如何解决？

问题根因 #

构建失败发生在根项目android配置阶段，本地Gradle缓存内com.google.code.findbugs:jsr305:3.0.2依赖的元数据描述文件损坏，通常由依赖下载时网络中断、缓存读写异常导致，和项目业务代码无关。

修复操作 #

• 清除损坏的本地Gradle缓存
  直接删除报错路径下的损坏文件目录：C:\Users\Pemula\.gradle\caches\modules-2\metadata-2.96\descriptors\com.google.code.findbugs\jsr305\3.0.2；如果要彻底排除缓存异常问题，可直接删除C:\Users\Pemula\.gradle\caches整个目录，后续构建时Gradle会自动重新拉取全量依赖。
• 清理项目侧构建缓存
  在Flutter项目根目录打开终端，依次执行以下命令：

  flutter clean
  flutter pub get
  

• 重新触发构建验证
  执行flutter run或flutter build apk --debug重新启动构建，损坏的依赖会自动重新下载，绝大多数场景下构建可恢复正常。

进阶排查 #

如果上述操作后仍构建失败，构建时追加参数输出详细日志定位具体问题：

flutter build apk --debug --stacktrace --info

国内网络环境下如果频繁出现依赖下载失败、文件损坏问题，直接修改项目android/build.gradle文件内的仓库配置，替换为国内Maven镜像源，提升依赖下载稳定性，避免同类问题重复出现。

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