RestControllerAdvice 全局语句失效

### 解决 `@RestControllerAdvice` 全局异常处理失效的问题

当遇到 `@RestControllerAdvice` 不起作用的情况时，通常是因为配置或项目结构存在问题。以下是几种常见的原因及其解决方案：

#### 1. 注解位置不当
确保全局异常处理器类上标注有 `@RestControllerAdvice` 或者 `@ControllerAdvice` 和 `@ResponseBody` 的组合[^1]。

@RestControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleAllExceptions(Exception ex) {
        return new ResponseEntity<>("An unexpected error occurred", HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

#### 2. 扫描路径未覆盖到该类
如果 Spring Boot 应用程序无法识别带有 `@RestControllerAdvice` 的类，则可能是由于组件扫描范围设置错误所致。确认主应用程序启动类位于包层次结构的根目录下，以便能够自动发现并注册所有控制器建议类。

#### 3. 返回类型不匹配
检查自定义异常处理器方法返回的对象是否与前端预期一致。对于 RESTful API 来说，最好总是返回 `ResponseEntity<?>` 类型的数据，这样可以更好地控制 HTTP 响应状态码和消息体的内容格式。

#### 4. 异常抛出点不在受监控范围内
只有被 Spring MVC 处理器映射的方法所引发的未经捕获的运行时异常才会触发全局异常拦截逻辑。因此要保证业务代码中的异常确实是从 Controller 层向外传播到了框架层面才能被捕获处理。