IntelliJ加载Gradle项目时创建Jar文件失败异常（Gradle 8.10.1）

问题描述 #

在IntelliJ中加载Gradle项目时，偶尔触发以下异常：

org.gradle.api.GradleException: Failed to create Jar file C:\Users\me\.gradle\caches\...jackson-core-2.15.2.jar

已确认本地Gradle版本为8.10.1，排除了Gradle 7.6.2之前版本的已知Bug。

可能的解决方案 #

• 清理Gradle缓存
  手动删除缓存目录 C:\Users\me\.gradle\caches，然后重新同步项目。缓存文件损坏是这类问题的常见诱因，彻底清理后Gradle会重新下载并生成完整的依赖文件。

• 检查IntelliJ使用的Gradle版本
  即使本地全局Gradle是8.10.1，IntelliJ可能单独配置了项目级的Gradle版本。打开项目的File > Settings > Build, Execution, Deployment > Build Tools > Gradle，确认"Gradle user home"和"Gradle version"是否与全局一致，若不一致改为8.10.1后重新同步。

• 修复文件权限问题
  目标Jar文件所在的缓存目录可能存在权限不足的情况。右键点击.gradle文件夹，选择"属性 > 安全"，确保当前用户拥有完全控制的权限，避免Gradle写入文件时被系统拦截。

• 禁用IntelliJ的Gradle离线模式
  若开启了离线模式，Gradle无法更新或重新下载损坏的依赖。在IntelliJ的Gradle工具栏中，取消勾选"Offline Mode"，然后执行Refresh Gradle Project。

• 强制重新下载依赖
  在项目根目录打开终端，执行命令：

  gradle clean build --refresh-dependencies
  

  该命令会清理构建产物并强制重新下载所有依赖，覆盖可能损坏的缓存文件。

• 检查磁盘空间
  确保C盘有足够的剩余空间，磁盘空间不足会导致Gradle无法完整写入Jar文件，进而触发创建失败的异常。

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