Java后端Controller全局异常处理方法

在Java后端开发中，如何优雅地处理Controller层全局异常？本文将深入探讨利用`@ControllerAdvice`和`@ExceptionHandler`注解实现统一异常管理的方法，旨在提升代码可维护性和接口一致性。通过创建全局异常处理类，我们可以拦截并处理所有Controller抛出的未处理异常，避免重复编写异常捕获逻辑。此外，结合自定义异常类（如`BusinessException`）和`@ResponseStatus`注解，能够更精细地控制异常处理流程，返回标准的HTTP状态码，从而构建清晰、统一的Controller层异常处理机制，方便前端解析错误信息，提升用户体验。掌握这些技巧，让你的Java后端代码更加健壮、易于维护。

使用@ControllerAdvice和@ExceptionHandler实现全局异常处理，结合自定义异常类（如BusinessException）和@ResponseStatus注解，统一管理Controller层异常，提升代码可维护性与接口一致性。

在Java后端开发中，处理Controller层的全局异常通常使用 @ControllerAdvice 和 @ExceptionHandler 注解来实现统一异常管理。这种方式可以避免在每个Controller中重复写异常捕获逻辑，提升代码可维护性。

1. 使用 @ControllerAdvice 统一处理异常

@ControllerAdvice 是一个全局异常处理器注解，作用于整个应用的所有Controller。它会拦截所有Controller抛出的未处理异常。

创建一个全局异常处理类：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleGenericException(Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("系统内部错误：" + e.getMessage());
    }

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<Map<String, Object>> handleNPE(NullPointerException e) {
        Map<String, Object> response = new HashMap<>();
        response.put("error", "空指针异常");
        response.put("message", e.getMessage());
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
    }
}

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

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

定义自定义异常：

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

在 Controller 中抛出：

@GetMapping("/user/{id}")
public User getUser(@PathVariable Long id) {
    if (id <= 0) {
        throw new BusinessException("用户ID不合法");
    }
    // ...
}

在全局处理器中添加对应处理方法：

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

3. 结合 @ResponseStatus 返回标准HTTP状态码

对于某些已知异常，可以直接用 @ResponseStatus 指定返回的状态码，简化响应逻辑。

例如：

@ResponseStatus(HttpStatus.NOT_FOUND)
public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String message) {
        super(message);
    }
}

当抛出 ResourceNotFoundException 时，自动返回 404 状态码，无需在 handler 中额外设置。 基本上就这些。通过组合使用 @ControllerAdvice、@ExceptionHandler 和自定义异常，就能实现清晰、统一的Controller层异常处理机制，既保证接口返回格式一致，又方便前端解析错误信息。

今天关于《Java后端Controller全局异常处理方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！