如何解决配置根项目'android'时出现的Gradle构建报错问题

报错核心信息 #

构建在配置根项目android阶段失败，抛出异常：

java.util.concurrent.ExecutionException: org.gradle.api.GradleException: 无法创建Jar文件 C:\Users\hp.gradle\caches\jars-9\f596b4dd337df4b4bc8d9a578e73e7d7\gradle-7.1.2.jar

该问题本质是Gradle进程无法对本地缓存目录完成文件写入操作，按以下优先级依次排查即可解决：

• 终止锁文件进程
  打开任务管理器，结束所有java.exe、gradle.exe、Android Studio相关进程，避免之前异常退出的Gradle守护进程锁定缓存路径，导致新的构建进程无法写入文件。
• 清理损坏缓存
  直接删除路径C:\Users\hp\.gradle\caches\jars-9整个文件夹，Gradle在下次构建时会自动重新生成对应缓存，不会影响项目正常运行。如果担心操作风险，可以先将该文件夹剪切到其他磁盘位置做备份。
• 修复目录权限
  右键点击C:\Users\hp\.gradle文件夹，依次打开「属性-安全」，确认当前登录的Windows账号对该目录拥有读取、写入、完全控制权限。如果权限缺失，点击「编辑」给当前账号分配对应权限，保存设置后重试构建。
• 排除拦截/磁盘问题
  检查C盘剩余可用空间，确保剩余空间不小于2G，避免磁盘满导致写入失败；临时关闭杀毒软件、系统安全防护工具，这类工具常误拦截Gradle写入Jar包的操作，关闭后重试构建。
• 重装对应Gradle版本
  以上操作无效时，删除C:\Users\hp\.gradle\wrapper\dists目录下的gradle-7.1.2版本文件夹，打开项目下gradle/wrapper/gradle-wrapper.properties确认版本配置无误后，重新同步项目，等待Gradle重新下载完整的7.1.2版本包即可。

操作完成后先在项目根目录执行gradlew.bat clean清理项目构建产物，再启动构建即可。

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