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后重新同步。
- macOS/Linux:
强制重新下载所有依赖
在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
相关产品推荐
相关产品推荐

