Apache服务器目录下Java解压文件失败：zip END header not found异常

这问题我之前帮同事排查过类似的，核心问题大概率是Apache的默认行为、文件上传过程或目录权限出了岔子，咱们一步步拆解解决：

1. 先确认Zip文件本身是否完整 #

java.util.zip.ZipError: zip END header not found这个异常本质就是Zip文件不完整或被篡改。虽然你在其他目录能正常解压，但上传到Apache的/var/www/html/files（应该是你笔误的fles？）后出问题，先做这两步验证：

• 用哈希值对比本地原文件和服务器上的文件，排查上传过程是否丢包：

  # 本地计算文件哈希
  md5sum your-target.zip
  # 服务器上对应目录计算哈希
  md5sum /var/www/html/files/your-target.zip
  

  如果哈希值不一致，说明上传环节有问题——比如Apache的上传模块（如mod_upload）有大小限制，或者客户端上传时意外中断。
• 用服务器的file命令直接检测文件真实类型：

  file /var/www/html/files/your-target.zip
  

  如果输出不是Zip archive data，那文件肯定被篡改了。

2. 为什么Files.probeContentType()返回text/plain？ #

这个返回值说明系统的文件类型检测机制被干扰了，大概率是这两个原因：

• Apache的MIME配置强制修改了类型：检查Apache的mime.conf或目标目录的.htaccess文件，看有没有强制把.zip文件设为text/plain的规则：

  grep -r "text/plain" /etc/apache2/conf-available/mime.conf
  grep -r "text/plain" /var/www/html/files/.htaccess
  

  如果找到相关规则，直接删除即可。
• 文件开头字节被修改：比如Apache的mod_security模块可能对上传文件做了过滤，无意中篡改了Zip文件的头部标识（正常Zip开头是PK\x03\x04）。

3. 检查Apache目录的权限与SELinux上下文 #

Apache运行用户（通常是www-data）的权限不足，可能导致写入文件时不完整：

• 查看目录和文件的权限：

  ls -ld /var/www/html/files
  ls -l /var/www/html/files/your-target.zip
  

  确保www-data拥有读写权限，文件的所有者和组也是www-data。
• 如果是开启了SELinux的系统，还要检查文件上下文：

  ls -Z /var/www/html/files/your-target.zip
  

  正常应该显示httpd_sys_rw_content_t类型，如果不是，用以下命令修改：

  chcon -t httpd_sys_rw_content_t /var/www/html/files/your-target.zip
  

4. Java代码的补充校验 #

虽然你说其他目录正常，但可以给代码加一层兜底校验，避免依赖不可靠的Files.probeContentType()：

try (InputStream is = new FileInputStream(targetFile)) {
    byte[] zipHeader = new byte[4];
    is.read(zipHeader);
    // 校验Zip文件的头部标识
    if (zipHeader[0] == 'P' && zipHeader[1] == 'K' && zipHeader[2] == 0x03 && zipHeader[3] == 0x04) {
        // 确认是合法Zip文件，执行解压逻辑
    } else {
        throw new IOException("上传的文件不是有效的Zip格式");
    }
}

内容的提问来源于stack exchange，提问作者Christoph S