@ControllerAdvice 属性

@ControllerAdvice 是一个注解，用于定义一个全局的异常处理器，它可以处理所有 Controller 层抛出的异常。该注解可以标注在类上，表示该类是一个全局异常处理器，同时可以使用 @ExceptionHandler 注解来定义具体的异常处理方法。这样，在程序运行过程中，当任意一个 Controller 抛出异常时，全局异常处理器会捕获该异常，并根据 @ExceptionHandler 注解中定义的方法来处理该异常。这样可以有效地减少重复代码的编写，提高开发效率，并且可以统一处理系统中的异常情况。

相关问题

@Controlleradvice

@ControllerAdvice是一个注解，用于增强@Controller的功能。它主要用于处理全局数据，并可以与@ExceptionHandler、@ModelAttribute和@InitBinder一起使用。[2]@ControllerAdvice提供了多种指定Advice规则的定义方式，可以通过指定包或指定注解来匹配需要增强的Controller。比如，可以使用basePackages属性指定需要增强的包及其子包下的所有Controller，也可以使用annotations属性指定需要增强的被特定注解修饰的Controller。[3]通过使用@ControllerAdvice注解，可以实现全局异常处理和预设全局数据的功能。

@ControllerAdvice basePackages

### @ControllerAdvice 中 basePackages 属性的用法

当希望 `@ControllerAdvice` 只作用于某些特定包内的控制器而非整个应用时，可以通过设置 `basePackages` 或者其别名 `value` 来实现这一目标[^2]。

#### 配置方式

为了使 `@ControllerAdvice` 的影响范围限定到指定路径下的控制器类，可以在定义该注解的时候传入相应的参数：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;

@ControllerAdvice(basePackages = "com.example.myapp.controllers") // 仅针对 com.example.myapp.controllers 下的 Controller 生效
public class CustomGlobalExceptionHandler {

    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<?> handleResourceNotFound(Exception ex) {
        ApiError apiError = new ApiError(HttpStatus.NOT_FOUND, ex.getMessage(), "resource_not_found");
        return new ResponseEntity<>(apiError, HttpStatus.NOT_FOUND);
    }
}

上述代码片段展示了如何利用 `basePackages` 参数来限制 `@ControllerAdvice` 的适用范围。这里假设存在名为 `CustomGlobalExceptionHandler` 的全局异常处理器只对位于 `com.example.myapp.controllers` 包及其子包中的控制器起作用。

#### 实践建议

- **模块化设计**：如果项目结构较为复杂，拥有多个独立的功能模块，则推荐按照业务逻辑划分不同的包，并分别为这些包创建对应的 `@ControllerAdvice` 类以便更好地管理各自特有的异常情况和其他横切关注点。

- **避免过度泛化**：虽然可以为整个应用程序提供统一的行为模式，但在实际开发过程中应当谨慎考虑是否真的有必要让所有的请求都遵循相同的规则；对于特殊场景应允许例外处理机制的存在。