Java項(xiàng)目中“zip END header not found“錯(cuò)誤的解決方案
更新時(shí)間：2025年06月05日 09:13:25 作者：李少兄
在 Java 項(xiàng)目構(gòu)建或運(yùn)行過(guò)程中,開(kāi)發(fā)者常會(huì)遇到 java.util.zip.ZipException: zip END header not found 錯(cuò)誤,這一異常通常與 JAR 文件損壞、下載不完整、編碼問(wèn)題或 Maven 依賴管理配置不當(dāng)有關(guān),本文給大家介紹了Java項(xiàng)目中“zip END header not found“錯(cuò)誤的解決方案
一、問(wèn)題本質(zhì)：JAR 文件損壞或 ZIP 格式異常
1.1 ZIP 文件結(jié)構(gòu)簡(jiǎn)析
ZIP 文件由多個(gè) 條目（Entry） 組成，每個(gè)條目包含：
- 本地文件頭（Local File Header）：記錄文件元數(shù)據(jù)（如文件名、壓縮算法）。
- 文件數(shù)據(jù)（File Data）：實(shí)際壓縮后的文件內(nèi)容。
- 中央目錄項(xiàng)（Central Directory Entry）：匯總所有條目信息。
- 結(jié)束標(biāo)記（END of Central Directory Record）：標(biāo)識(shí) ZIP 文件的結(jié)尾。
當(dāng) ZipFile 或 ZipInputStream 在讀取 ZIP 文件時(shí)發(fā)現(xiàn) 缺失 END 標(biāo)記，便會(huì)拋出 ZipException。
1.2 常見(jiàn)觸發(fā)場(chǎng)景
| 場(chǎng)景 | 描述 | 示例錯(cuò)誤日志 |
|---|---|---|
| JAR 文件損壞 | 下載中斷或存儲(chǔ)異常導(dǎo)致文件不完整 | java.util.zip.ZipException: zip END header not found |
| 編碼問(wèn)題 | 中文文件名未使用正確字符集解析 | java.lang.IllegalArgumentException: MALFORMED |
| ZIP64 格式支持不足 | 大文件超出標(biāo)準(zhǔn) ZIP 格式限制 | invalid zip64 extra data field size |
| 依賴沖突 | 多個(gè)版本的依賴共存導(dǎo)致類路徑?jīng)_突 | ClassCastException 或 NoClassDefFoundError |
二、成因分析與解決方案
2.1 場(chǎng)景 1：JAR 文件損壞
成因
- 網(wǎng)絡(luò)中斷：Maven 從遠(yuǎn)程倉(cāng)庫(kù)（如阿里云鏡像）下載 JAR 時(shí)，因網(wǎng)絡(luò)波動(dòng)導(dǎo)致文件未完全寫入。
- 鏡像倉(cāng)庫(kù)問(wèn)題：第三方鏡像倉(cāng)庫(kù)（如阿里云、華為云）提供損壞的 JAR 文件。
- 磁盤空間不足：本地倉(cāng)庫(kù)目錄空間不足，導(dǎo)致文件寫入失敗。
解決方案
步驟 1：刪除本地倉(cāng)庫(kù)中的損壞文件
# Windows rm -rf ~/.m2/repository/com/konghq/unirest-java/3.14.5/ # Linux/macOS rm -rf ~/.m2/repository/com/konghq/unirest-java/3.14.5/
步驟 2：強(qiáng)制重新下載依賴
mvn dependency:purge-local-repository clean install -U
步驟 3：手動(dòng)下載并替換 JAR 文件
- 從 Maven Central 獲取正確版本的 JAR 文件。
- 替換到本地倉(cāng)庫(kù)路徑：
cp unirest-java-3.14.5.jar ~/.m2/repository/com/konghq/unirest-java/3.14.5/
驗(yàn)證校驗(yàn)值
使用 SHA1 校驗(yàn)文件完整性：
certutil -hashfile unirest-java-3.14.5.jar SHA1
2.2 場(chǎng)景 2：編碼問(wèn)題導(dǎo)致 ZIP 解析失敗
成因
- ZIP 文件中的中文文件名使用 GBK 編碼，而 Java 默認(rèn)使用 UTF-8 解析。
解決方案
代碼示例：指定字符集解析 ZIP 文件
import java.io.FileInputStream;
import java.nio.charset.Charset;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;
public class ZipHandler {
public static void main(String[] args) throws Exception {
String zipFilePath = "path/to/your/file.zip";
try (FileInputStream fis = new FileInputStream(zipFilePath);
ZipInputStream zis = new ZipInputStream(fis, Charset.forName("GBK"))) { // 指定 GBK 編碼
ZipEntry entry;
while ((entry = zis.getNextEntry()) != null) {
System.out.println("Entry: " + entry.getName());
// 處理文件內(nèi)容...
}
}
}
}
Maven 依賴管理
若需處理中文文件名的依賴（如 Spring Boot 項(xiàng)目），確保依賴的 JAR 文件本身無(wú)編碼問(wèn)題。
2.3 場(chǎng)景 3：ZIP64 格式支持不足
成因
- 文件大小超過(guò) 4GB（ZIP 標(biāo)準(zhǔn)限制），導(dǎo)致使用 ZIP64 擴(kuò)展格式。
- 舊版 JDK（如 Java 7）或 Maven 插件不支持 ZIP64。
解決方案
升級(jí) JDK
使用 Java 8 或更高版本，支持 ZIP64 格式：
# 檢查 JDK 版本 java -version
配置 Maven 支持大文件
在 settings.xml 中啟用 ZIP64 支持：
<systemProperties>
<net.java.dev.jna.zip64.enabled>true</net.java.dev.jna.zip64.enabled>
</systemProperties>
使用 Apache Commons Compress
替代 java.util.zip，支持 ZIP64：
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-compress</artifactId>
<version>1.21</version>
</dependency>
代碼示例
import org.apache.commons.compress.archivers.zip.ZipArchiveEntry;
import org.apache.commons.compress.archivers.zip.ZipFile;
public class Zip64Handler {
public static void main(String[] args) throws Exception {
String zipFilePath = "path/to/large-file.zip";
try (ZipFile zipFile = new ZipFile(zipFilePath)) {
for (ZipArchiveEntry entry : zipFile.getEntries()) {
System.out.println("Entry: " + entry.getName());
}
}
}
}
2.4 場(chǎng)景 4：依賴沖突導(dǎo)致類路徑異常
成因
- 多個(gè)依賴引入相同庫(kù)的不同版本（如
com.mashape.unirest:unirest-java與com.konghq:unirest-java）。 - 依賴傳遞性導(dǎo)致版本不一致。
解決方案
排除沖突依賴
在 pom.xml 中顯式排除舊版依賴：
<dependency>
<groupId>third-party-group</groupId>
<artifactId>third-party-lib</artifactId>
<version>1.0.0</version>
<exclusions>
<exclusion>
<groupId>com.mashape.unirest</groupId>
<artifactId>unirest-java</artifactId>
</exclusion>
</exclusions>
</dependency>
統(tǒng)一依賴管理
使用 dependencyManagement 強(qiáng)制版本一致性：
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.konghq</groupId>
<artifactId>unirest-java</artifactId>
<version>3.14.5</version>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.konghq</groupId>
<artifactId>unirest-java</artifactId>
</dependency>
</dependencies>
三、高級(jí)技巧與最佳實(shí)踐
3.1 Maven 鏡像優(yōu)化
切換鏡像倉(cāng)庫(kù)
避免使用可能損壞的鏡像，優(yōu)先使用官方倉(cāng)庫(kù)：
<mirrors>
<mirror>
<id>central</id>
<url>https://repo1.maven.org/maven2</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
鏡像覆蓋策略
若需使用第三方鏡像，建議覆蓋所有倉(cāng)庫(kù)：
<mirror>
<id>aliyunmaven</id>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>*</mirrorOf>
</mirror>
3.2 依賴校驗(yàn)工具
Maven Enforcer Plugin
禁止特定版本的依賴：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-enforcer-plugin</artifactId>
<version>3.0.0</version>
<executions>
<execution>
<id>enforce-banned-dependencies</id>
<goals>
<goal>enforce</goal>
</goals>
<configuration>
<rules>
<bannedDependencies>
<excludes>
<exclude>com.mashape.unirest:unirest-java</exclude>
</excludes>
</bannedDependencies>
</rules>
</configuration>
</execution>
</executions>
</plugin>
3.3 日志與調(diào)試
打印依賴樹(shù)
定位沖突依賴：
mvn dependency:tree
檢查文件完整性
使用 jar 命令驗(yàn)證 JAR 文件：
jar tf unirest-java-3.14.5.jar
四、總結(jié)
| 問(wèn)題類型 | 原因 | 解決方案 |
|---|---|---|
| JAR 文件損壞 | 網(wǎng)絡(luò)中斷、鏡像問(wèn)題 | 刪除本地緩存，強(qiáng)制重新下載 |
| 編碼問(wèn)題 | 中文文件名亂碼 | 指定字符集解析 ZIP 文件 |
| ZIP64 支持不足 | 文件過(guò)大 | 升級(jí) JDK，使用 Apache Commons Compress |
| 依賴沖突 | 多個(gè)版本共存 | 排除舊版依賴，統(tǒng)一版本管理 |
以上就是Java項(xiàng)目中“zip END header not found“錯(cuò)誤的解決方案的詳細(xì)內(nèi)容，更多關(guān)于Java錯(cuò)誤zip END header not found的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
您可能感興趣的文章:
- 如何解決遇到的錯(cuò)誤信息?java:?找不到符號(hào)?符號(hào):?變量?log
- Java常見(jiàn)報(bào)錯(cuò)類型及解決方案詳細(xì)解析(從異常處理到錯(cuò)誤排查)
- 解決tomcat啟動(dòng)時(shí)報(bào)Junit相關(guān)錯(cuò)誤java.lang.ClassNotFoundException: org.junit.Test問(wèn)題
- Java NoClassDefFoundError運(yùn)行時(shí)錯(cuò)誤分析解決
- IDEA中錯(cuò)誤：java: java.lang.NoSuchFieldError的問(wèn)題解決
相關(guān)文章
SpringBoot用JdbcTemplates操作Mysql實(shí)例代碼詳解
JdbcTemplate是Spring框架自帶的對(duì)JDBC操作的封裝，目的是提供統(tǒng)一的模板方法使對(duì)數(shù)據(jù)庫(kù)的操作更加方便、友好，效率也不錯(cuò)，這篇文章主要介紹了SpringBoot用JdbcTemplates操作Mysql2022-10-10
這篇文章主要介紹了java多線程之CyclicBarrier的使用方法的相關(guān)資料,希望通過(guò)本文能幫助到大家，讓大家理解掌握這部分內(nèi)容，需要的朋友可以參考下2017-10-10
分享Java性能調(diào)優(yōu)的11個(gè)實(shí)用技巧
這些建議中的大多數(shù)都是基于Java的，但是也不一定，也有一些是可以應(yīng)用于所有的應(yīng)用程序和編程語(yǔ)言的。在我們分享基于Java的性能調(diào)優(yōu)技巧之前，讓我們先討論一下這些通用的性能調(diào)優(yōu)技巧2017-11-11
Java網(wǎng)絡(luò)編程教程之設(shè)置請(qǐng)求超時(shí)的方法
這篇文章主要給大家介紹了關(guān)于Java網(wǎng)絡(luò)編程教程之設(shè)置請(qǐng)求超時(shí)的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧。2017-12-12
Java 1,2,3,4能組成多少個(gè)互不相同且無(wú)重復(fù)數(shù)字的實(shí)現(xiàn)代碼
這篇文章主要介紹了Java 1,2,3,4能組成多少個(gè)互不相同且無(wú)重復(fù)數(shù)字的實(shí)現(xiàn)代碼,需要的朋友可以參考下2017-02-02
MyBatis處理大字段或BLOB、CLOB類型數(shù)據(jù)方式
這篇文章主要介紹了MyBatis處理大字段或BLOB、CLOB類型數(shù)據(jù)方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-04-04
Spring Boot 2.X整合Spring-cache(讓你的網(wǎng)站速度飛起來(lái))
這篇文章主要介紹了Spring Boot 2.X整合Spring-cache(讓你的網(wǎng)站速度飛起來(lái))，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-09-09
這篇文章主要介紹了nacos配置中心持久化相關(guān)配置方式，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-11-11
這篇文章主要介紹了Java中MinIO的常用操作示例,MinIO 是一款基于Go語(yǔ)言發(fā)開(kāi)的高性能、分布式的對(duì)象存儲(chǔ)系統(tǒng),客戶端支持Java,Net,Python,Javacript, Golang語(yǔ)言,需要的朋友可以參考下2024-01-01
Spring整合quartz做定時(shí)任務(wù)的示例代碼
這篇文章主要介紹了在spring項(xiàng)目使用quartz做定時(shí)任務(wù),首先我這里的項(xiàng)目已經(jīng)是一個(gè)可以跑起來(lái)的完整項(xiàng)目，web.xml里面的配置我就不貼出來(lái)了，具體實(shí)例代碼跟隨小編一起看看吧2022-01-01