Spring Boot 3中@RestControllerAdvice自定义异常未生效，仍返回500错误

问题根源 #

1. 你继承了ResponseEntityExceptionHandler，这个父类的默认异常处理逻辑会和你用@ResponseStatus配合返回自定义对象的方式冲突，导致状态码设置失效。
2. 代码里的Messsage拼错了（多了一个s），如果这个类序列化时出错，会触发新的异常，最终返回500。
3. 全局异常直接捕获Exception.class范围太广，可能拦截了框架内部的异常，干扰了正常的状态码返回逻辑。

修正方案 #

方案1：去掉ResponseEntityExceptionHandler继承（推荐） #

如果不需要复用父类的异常处理逻辑，直接移除继承，@ResponseStatus就能正常生效：

@RestControllerAdvice
public class ControllerExceptionHandler {

    @ExceptionHandler(ResourceNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public Message resourceNotFoundException(ResourceNotFoundException exception, WebRequest request) {
        return new Message(HttpStatus.NOT_FOUND.value(), exception.getMessage(), LocalDateTime.now());
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR) // 全局异常建议返回500，不要都设成404
    public Message globalException(Exception exception, WebRequest request) {
        return new Message(HttpStatus.INTERNAL_SERVER_ERROR.value(), exception.getMessage(), LocalDateTime.now());
    }
}

方案2：保留继承时返回ResponseEntity #

如果必须继承ResponseEntityExceptionHandler，就用ResponseEntity来明确控制响应内容和状态码，避免父类逻辑干扰：

@RestControllerAdvice
public class ControllerExceptionHandler extends ResponseEntityExceptionHandler {

    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<Message> resourceNotFoundException(ResourceNotFoundException exception, WebRequest request) {
        Message message = new Message(HttpStatus.NOT_FOUND.value(), exception.getMessage(), LocalDateTime.now());
        return new ResponseEntity<>(message, HttpStatus.NOT_FOUND);
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<Message> globalException(Exception exception, WebRequest request) {
        Message message = new Message(HttpStatus.INTERNAL_SERVER_ERROR.value(), exception.getMessage(), LocalDateTime.now());
        return new ResponseEntity<>(message, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

必做检查 #

• 把Messsage改成正确的Message，确保这个类有完整的getter方法（比如用Lombok的@Data注解），不然Spring没法正常序列化返回结果。
• 全局异常别直接抓Exception.class，尽量缩小到自定义异常或业务相关异常，防止误拦截框架内部的正常异常处理。

内容的提问来源于stack exchange，提问作者Ranjit Singh