使用 @controlleradvice 结合 @exceptionhandler 可以统一捕获文件读写异常。核心做法是定义一个全局异常处理类,在方法上指定需要捕获的异常类型(如 ioexception),并在方法内部返回自定义的错误响应对象。这样当控制器中发生文件读取或写入错误时,spring boot 会自动拦截并执行该逻辑,避免程序崩溃。

如何配置全局异常处理器来拦截 IO 异常
通过继承 ResponseEntityExceptionHandler 或直接使用注解,可以创建专门处理 IOException 的全局处理器。关键在于将异常实例作为参数注入到处理方法中,以便获取具体的错误信息。配置完成后,任何抛出的未捕获 IO 异常都会触发此逻辑,返回统一的 JSON 格式错误提示。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import java.io.IOException;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(IOException.class)
public ResponseEntity<string> handleFileIOException(IOException ex) {
return ResponseEntity.status(500).body("File operation failed: " + ex.getMessage());
}
}</string>
如何在业务代码中触发并验证该异常捕获
在 Controller 层模拟文件操作失败的场景,例如尝试读取一个不存在的文件或权限不足的文件。当代码执行到 Files.readAllBytes() 或类似方法时,若抛出 FileNotFoundException(它是 IOException 的子类),全局处理器会立即接管。验证方法是观察 HTTP 响应状态码是否为 500,且 Body 中包含预期的错误描述字符串,证明异常已被正确路由至全局处理逻辑。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.nio.file.Files;
import java.nio.file.Paths;
@RestController
public class FileController {
@GetMapping("/read")
public String readFile() throws IOException {
// 故意读取一个不存在的路径以触发异常
byte[] bytes = Files.readAllBytes(Paths.get("/nonexistent/file.txt"));
return new String(bytes);
}
}
当捕获到具体子类异常时如何处理特定逻辑
虽然 IOException 能覆盖大多数文件操作错误,但有时需要针对 FileNotFoundException 或 AccessDeniedException 做差异化处理。可以在同一个 @ControllerAdvice 类中添加多个 @ExceptionHandler 方法,分别对应不同的子类异常。Spring 会根据异常的实际类型匹配最精确的处理方法,从而允许对“文件不存在”和“权限拒绝”返回不同的状态码或提示信息,提升 API 的语义准确性。











