使用Gradle构建MapReduce项目时出现Could not expand ZIP错误

问题背景 #

开发MapReduce应用，使用Gradle构建，引入依赖：

implementation 'org.apache.hive:hive-jdbc:3.1.3'
implementation 'org.apache.hadoop:hadoop-common:3.3.2'
implementation 'org.apache.hadoop:hadoop-hdfs:3.3.2'

执行./gradlew clean build时出现错误：

Could not expand ZIP 'C:\Users\..\.gradle\caches\modules-2\files-2.1\org.apache.curator\apache-curator\2.12.0\b1ff6ce0741facb15217ae9254ee7167bc7b15e\apache-curator-2.12.0.pom'.

org.gradle.api.tasks.TaskExecutionException: Execution failed for task ':jar'.
        at org.gradle.api.internal.tasks.execution.ExecuteActionsTaskExecuter.lambda$executeIfValid$1(ExecuteActionsTaskExecuter.java:188)
        at org.gradle.internal.Try$Failure.ifSuccessfulOrElse(Try.java:282)
        at org.gradle.api.internal.tasks.execution.ExecuteActionsTaskExecuter.executeIfValid(ExecuteActionsTaskExecuter.java:186)

已尝试gradlew cleanBuildCache --refresh-dependencies，问题未解决。

解决方案 #

1. 手动删除损坏的缓存文件 #

Gradle报错路径指向.pom文件却提示无法解压ZIP，说明该pom文件已损坏或缓存关联错误：

• 定位到缓存目录：C:\Users\<你的用户名>\.gradle\caches\modules-2\files-2.1\org.apache.curator\apache-curator\2.12.0\b1ff6ce0741facb15217ae9254ee7167bc7b15e
• 删除该目录下的apache-curator-2.12.0.pom，或直接删除整个2.12.0目录

2. 强制重新拉取依赖并构建 #

执行以下命令，确保Gradle重新下载所有依赖并构建：

./gradlew clean build --refresh-dependencies

注意：--refresh-dependencies需要和build命令一起执行，单独清理缓存无法触发依赖重新下载。

3. 排查依赖版本兼容性 #

hive-jdbc 3.1.3依赖的curator 2.12.0可能与hadoop 3.3.2存在版本冲突：

• 执行./gradlew dependencies查看完整依赖树，确认hadoop-common 3.3.2依赖的curator版本
• 如果存在冲突，在build.gradle中强制指定兼容的curator版本：

  configurations.all {
      resolutionStrategy.force 'org.apache.curator:apache-curator:4.3.0' // 示例版本，以实际兼容版本为准
  }
  

4. 检查本地Maven仓库（若有配置） #

如果Gradle配置了本地Maven仓库，检查仓库中org/apache/curator/apache-curator/2.12.0目录下的pom文件是否损坏，删除后重新执行构建命令。

5. 切换仓库源（解决下载损坏问题） #

若依赖下载时因仓库源不稳定导致文件损坏，可临时切换到国内镜像源，在build.gradle的repositories块中添加：

repositories {
    maven { url 'https://maven.aliyun.com/repository/public/' }
    mavenCentral()
}

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