spring boot 全局异常处理捕获文件上传异常,核心在于利用 @controlleradvice 配合 @exceptionhandler 拦截 multipartexception。当上传的文件大小超过配置限制或格式错误时,spring 会抛出此类异常,通过定义专门的处理方法即可统一返回 json 响应。

如何配置最大文件大小以避免异常发生?
可以通过修改 application.yml 中的 spring.servlet.multipart.max-file-size 和 max-request-size 参数来调整阈值。如果希望完全禁用限制,可以设置为 -1,但通常建议根据业务需求设置合理上限以防止服务器资源耗尽。

自定义异常类如何实现更细粒度的控制?
继承 MultipartException 创建自定义异常类,可以在全局处理器中区分不同类型的上传错误。例如,区分文件大小超限与文件格式不支持,从而在响应中提供更具针对性的错误信息。
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.multipart.MultipartException;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;
import java.util.HashMap;
import java.util.Map;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MultipartException.class)
public ResponseEntity<Map<String, Object>> handleMultipartException(MultipartException ex) {
Map<String, Object> body = new HashMap<>();
body.put("error", "File Upload Failed");
body.put("message", ex.getMessage());
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(body);
}
}


















