Java里如何使用ExceptionHandler统一处理Web请求异常_Web异常集中处理方法说明-java教程-PHP中文网

Java里如何使用ExceptionHandler统一处理Web请求异常_Web异常集中处理方法说明

P粉602998670

发布： 2025-12-09 16:12:02

原创

686人浏览过

通过@ControllerAdvice和@ExceptionHandler实现全局异常处理，结合自定义业务异常、ResponseStatus注解及验证异常捕获，可统一返回结构化错误信息，提升接口健壮性与用户体验。

java里如何使用exceptionhandler统一处理web请求异常_web异常集中处理方法说明

在Java的Web开发中，特别是在使用Spring或Spring Boot框架时，统一处理Web请求异常可以极大提升代码的可维护性和用户体验。通过@ControllerAdvice和@ExceptionHandler注解，我们可以实现全局异常集中管理，避免在每个控制器中重复写异常捕获逻辑。

1. 使用@ControllerAdvice和@ExceptionHandler处理异常

Spring提供了@ControllerAdvice注解，用于定义全局异常处理器。它能拦截所有控制器抛出的异常，并通过@ExceptionHandler指定处理方法。

示例代码如下：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointer(NullPointerException e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("发生了空指针异常：" + e.getMessage());
    }

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<Map<String, Object>> handleIllegalArgument(IllegalArgumentException e) {
        Map<String, Object> error = new HashMap<>();
        error.put("error", "参数错误");
        error.put("message", e.getMessage());
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, Object>> handleGeneralException(Exception e) {
        Map<String, Object> error = new HashMap<>();
        error.put("error", "服务器内部错误");
        error.put("message", e.getClass().getSimpleName() + ": " + e.getMessage());
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
    }
}

登录后复制

上述代码中，不同类型的异常由不同的方法处理，返回结构化的错误响应。最通用的Exception.class放在最后，作为兜底处理。

立即学习“Java免费学习笔记（深入）”；

2. 自定义业务异常并统一处理

在实际项目中，建议定义自己的业务异常类，便于区分系统异常和业务逻辑异常。

public class BusinessException extends RuntimeException {
    public BusinessException(String message) {
        super(message);
    }
}

登录后复制

然后在全局异常处理器中添加对应处理方法：

ImgGood

免费在线AI照片编辑器

查看详情

@ExceptionHandler(BusinessException.class)
public ResponseEntity<Map<String, Object>> handleBusinessException(BusinessException e) {
    Map<String, Object> response = new HashMap<>();
    response.put("error", "业务异常");
    response.put("message", e.getMessage());
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
}

登录后复制

这样在Service或Controller中可以直接抛出throw new BusinessException("用户名已存在")，由全局处理器统一响应。

3. 结合ResponseStatus注解简化处理

除了在@ExceptionHandler中手动设置HTTP状态码，也可以在自定义异常上使用@ResponseStatus注解，自动映射状态码。

@ResponseStatus(value = HttpStatus.FORBIDDEN, reason = "权限不足")
public class AccessDeniedException extends RuntimeException {
    public AccessDeniedException(String message) {
        super(message);
    }
}

登录后复制

只要这个异常被抛出，Spring会自动返回403状态码，无需在@ExceptionHandler中再指定状态。

4. 处理验证异常（如MethodArgumentNotValidException）

当使用@Valid进行参数校验时，若校验失败会抛出MethodArgumentNotValidException。可以在全局处理器中捕获并提取错误字段信息。

@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, Object>> handleValidationException(MethodArgumentNotValidException e) {
    Map<String, Object> errors = new HashMap<>();
    errors.put("error", "参数校验失败");
    List<String> messages = e.getBindingResult()
            .getFieldErrors()
            .stream()
            .map(FieldError::getDefaultMessage)
            .collect(Collectors.toList());
    errors.put("messages", messages);
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errors);
}

登录后复制

这样前端能收到具体的字段错误提示，提升交互体验。

基本上就这些。通过合理使用@ControllerAdvice和@ExceptionHandler，配合自定义异常和验证处理，可以实现清晰、统一的Web异常响应机制，让后端接口更健壮、易维护。

以上就是Java里如何使用ExceptionHandler统一处理Web请求异常_Web异常集中处理方法说明的详细内容，更多请关注php中文网其它相关文章！