使用 @controlleradvice 结合 @exceptionhandler 可以捕获压缩解压异常。针对常见的 gzipexception、zipexception 或 dataformatexception,在 advice 类中定义处理方法并返回统一的错误响应对象即可。

@ExceptionHandler 如何匹配具体的解压异常类型
Spring Boot 的异常处理机制通过遍历注册的处理器来寻找第一个能处理当前异常的 Bean。对于解压操作,最常遇到的是 java.util.zip.ZipException(文件损坏)和 java.io.DataFormatException(数据格式错误)。需要在代码中显式声明这些异常类型,确保它们被正确拦截。

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;
import java.util.zip.ZipException;
import java.io.DataFormatException;
@ControllerAdvice
public class GlobalCompressionExceptionHandler {
@ExceptionHandler(ZipException.class)
public ResponseEntity<String> handleZipException(ZipException ex) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("ZIP file is corrupted: " + ex.getMessage());
}
@ExceptionHandler(DataFormatException.class)
public ResponseEntity<String> handleDataFormatEx(DataFormatException ex) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Invalid data format: " + ex.getMessage());
}
}
上述代码展示了两个独立的处理方法。当控制器抛出 ZipException 时,第一个方法生效;抛出 DataFormatException 时,第二个方法生效。两者都返回 400 Bad Request 状态码及具体的错误信息字符串。
如何处理未预期的通用 IO 异常
除了特定的压缩库异常外,解压过程还可能因为文件不存在、权限不足或流关闭失败而抛出通用的 IOException。为了程序的健壮性,需要捕获这些更广泛的异常作为兜底策略,防止系统因未处理的 IO 错误而崩溃。

import java.io.IOException;
// ... 在同一个 ControllerAdvice 类中 ...
@ExceptionHandler(IOException.class)
public ResponseEntity<String> handleIOException(IOException ex) {
// 避免捕获到非压缩相关的 IO 异常,可根据具体场景细化
if (ex.getMessage() != null && ex.getMessage().contains("zip")) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("IO error during decompression");
}
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Unexpected IO error");
}
这段代码补充了前文的逻辑。它捕获了 IOException,并在内部通过检查消息内容来区分是否为压缩相关错误。这种处理方式确保了即使出现非标准的 IO 问题,用户也能收到明确的错误反馈,而不是默认的 500 页面。
解压过程中 ZipEntry 为空时的具体行为是什么
在解压 ZIP 文件时,如果迭代 ZipInputStream 获取到的 ZipEntry 为 null,这通常表示流的结束。此时不应尝试读取数据,而应正常关闭流并结束解压循环。若强行读取会导致 NullPointerException 或无效的数据写入。


















