Flutter项目迁移后Gradle配置根项目android报错:锁协议不匹配

该报错核心是项目迁移复制过程中，Android目录下专属的Gradle临时文件、锁文件出现损坏，仅清理全局Gradle缓存无法解决，按以下步骤操作即可修复：

• 清理项目本地构建残留与损坏配置
  首先在项目根目录执行命令：

  flutter clean
  

  执行完成后手动删除项目android/.gradle文件夹，该目录存储当前项目专属的Gradle临时文件、锁文件，是迁移过程中最容易出现损坏的位置。
• 校验Gradle版本匹配关系
  打开android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl对应的Gradle版本与android/build.gradle中的Android Gradle插件版本匹配，常规对应关系为：Gradle 7.4对应AGP 7.0~7.3版本，Gradle 7.5对应AGP 7.1~7.4版本。
• 终止后台残留Gradle进程
  Windows系统执行命令：

  taskkill /f /im java.exe
  

  Mac/Linux系统执行命令：

  killall java
  

  避免后台挂起的Gradle进程占用锁文件导致新构建失败。
• 重新启动构建
  先执行flutter pub get拉取项目依赖，之后正常启动项目构建即可。

若以上操作后仍报错，可直接删除整个android目录，在项目根目录执行flutter create .命令，Flutter会自动生成全新的Android原生配置文件，之后将你之前修改过的签名配置、自定义原生配置内容还原即可，该方案可以覆盖所有配置类损坏导致的构建问题。

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