使用 @restcontrolleradvice 结合 @exceptionhandler 可以捕获消费者提交时抛出的异常。核心做法是定义一个全局异常处理类,在方法上标注 @exceptionhandler 并指定需要捕获的异常类型,spring boot 会自动将控制器中未处理的异常路由到这些方法中进行统一响应。

@RestControllerAdvice 如何拦截请求异常
通过继承 ResponseEntityExceptionHandler 或直接使用注解,可以拦截所有 @RestController 中的异常。当消费者发送请求导致业务逻辑或参数校验失败时,框架会抛出异常,全局处理器会捕获它并返回自定义的 JSON 结构。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(IllegalArgumentException.class)
public ResponseEntity<string> handleIllegalArgument(IllegalArgumentException ex) {
return ResponseEntity.badRequest().body("参数错误: " + ex.getMessage());
}
}</string>
上述代码定义了针对 IllegalArgumentException 的处理逻辑。当消费者提交的数据不符合预期(例如 ID 为负数)时,控制器抛出该异常,全局处理器将其转换为 HTTP 400 状态码和包含错误信息的 Body。这种机制确保了无论哪个 Controller 抛出异常,都能得到一致的响应格式。
如何处理具体的业务验证异常
除了系统级异常,通常还需要处理业务层面的验证失败。可以通过定义自定义异常类并在 @RestControllerAdvice 中专门处理它们,从而区分不同的错误场景。例如,处理用户不存在或权限不足的情况。

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class BusinessExceptionHandler {
@ExceptionHandler(UserNotFoundException.class)
public ResponseEntity<string> handleUserNotFound(UserNotFoundException ex) {
return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());
}
}</string>
这段代码展示了如何处理自定义的 UserNotFoundException。当业务逻辑发现用户不存在时,抛出此异常,全局处理器捕获后返回 HTTP 404 状态码。这种方式允许开发者根据具体的业务语义返回不同的状态码和提示信息,提升了 API 的可读性和调试效率。
当消费者提交空值时会发生什么
如果消费者提交的参数为空,且代码中没有进行显式的非空判断,通常会触发特定的运行时异常或默认行为。在全局异常处理器的视角下,这取决于具体抛出的异常类型。例如,若尝试访问空对象的属性,可能抛出 NullPointerException;若使用了 JSR-303 校验,则可能抛出 MethodArgumentNotValidException。











