升级Flutter 2.0.1后安卓端运行demo卡在running gradle的问题咨询

已知你当前环境Web端可在220秒内正常构建完成，说明Flutter SDK核心文件无损坏、基础运行环境正常，问题集中在Android侧的Gradle构建链路，可按以下步骤逐一排查修复：

常见问题对应修复方案 #

• Gradle境外资源下载阻塞
  Flutter 2.0.1 默认匹配的Gradle、Android插件版本较老，首次构建时需要拉取的依赖默认从境外仓库请求资源，无适配网络环境时会出现长时间无进度的假死状态，典型表现为日志完全无输出、不存在任何下载进度提示。
  修复操作：
  • 打开项目路径下 android/build.gradle，找到buildscript、allprojects两个块内的repositories配置，将原有境外Maven仓库的请求顺序后置，优先接入可正常访问的镜像源，移除会触发无效境外请求的冗余仓库地址。
  • 检查用户目录下的~/.gradle/gradle.properties配置文件，删除和当前网络环境不匹配的无效代理参数（如systemProp.http.proxyHost、systemProp.https.proxyHost类配置行）。
• Gradle与AGP版本适配错配
  升级Flutter 2.0.1后若未同步调整项目Android端的Gradle版本，会触发构建进程无提示挂起。
  修复操作：
  • 打开项目路径下 android/gradle/wrapper/gradle-wrapper.properties，将distributionUrl调整为Flutter 2.0.1 官方适配的Gradle 6.7版本，避免使用跨版本兼容的不匹配Gradle版本。
  • 修改同项目下的android/build.gradle文件，将com.android.tools.build:gradle（即AGP）版本调整为和Gradle 6.7 适配的4.2.2版本。
• 残留构建进程引发的文件锁死锁
  上一次失败的构建进程未正常退出，会持有Gradle缓存目录的文件锁，导致新启动的构建进程一直等待锁释放，表现为停留在Running Gradle...提示无任何进度输出。
  修复操作：
  • 先执行flutter clean命令清理项目残留的构建产物。
  • 手动删除项目根目录下的.gradle、build文件夹，同时清理用户目录下.gradle/caches路径下对应版本的.lock后缀临时锁文件。
  • 重新执行构建时添加--verbose参数，即可实时看到Gradle的实际运行日志，精准定位具体阻塞节点。
• 本地Android SDK 组件缺失
  若构建时需要的对应版本SDK、构建工具未在本地完整安装，Gradle会在后台静默等待资源拉取，表面无进度输出。
  修复操作：打开Android Studio的SDK管理器，确认已安装API 30对应的SDK平台、Build-Tools 30.0.3版本，不存在缺失组件的情况。
• Android SDK 版本配置不兼容
  Flutter 2.0.1 的适配要求为Android compileSdk版本30，若项目配置的compileSdk版本偏离该值，会触发Gradle构建静默阻塞。
  修复操作：打开项目路径下 android/app/build.gradle，将compileSdkVersion、targetSdkVersion统一调整为30，和Flutter版本的适配要求保持一致，不要直接沿用高版本Flutter的SDK配置参数。

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