You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Gradle项目同步失败:zip END header not found问题求助

解决Gradle同步报错“zip END header not found”的方案

这个报错本质是Gradle本地缓存的依赖文件损坏,或是依赖下载不完整导致的,以下是针对性解决步骤:

  • 清理Gradle本地缓存
    找到本地Gradle缓存目录:

    • macOS/Linux:~/.gradle/caches
    • Windows:C:\Users\<你的用户名>\.gradle\caches
      删除该目录下所有内容,或仅删除包含jetifier-core的缓存文件夹,重启Android Studio后重新同步。
  • 强制重新下载所有依赖
    在Android Studio的Terminal中执行命令:

    # macOS/Linux
    ./gradlew clean build --refresh-dependencies
    
    # Windows
    gradlew clean build --refresh-dependencies
    

    该命令会跳过本地缓存,强制Gradle重新拉取所有依赖文件。

  • 切换稳定的依赖镜像源
    如果网络访问官方仓库不稳定,可在项目根目录的build.gradle中替换为国内镜像源:

    buildscript {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
            mavenCentral()
        }
        // 原有配置保留
    }
    
    allprojects {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/public' }
            mavenCentral()
        }
    }
    
  • 检查Jetifier配置与AGP版本
    打开项目根目录的gradle.properties,若存在android.enableJetifier=true,确保项目使用的Android Gradle Plugin(AGP)为稳定版本,无需单独指定旧版jetifier-core依赖——Jetifier会随AGP自动适配。

  • 验证模拟器与项目配置兼容性
    确认平板模拟器的API级别,与项目build.gradle(模块级)中compileSdk、targetSdk版本匹配,避免因API版本不兼容触发依赖解析异常。

内容的提问来源于stack exchange,提问作者Anil Anvesh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 12:29:55