如何限制指定@ExceptionHandler的Controller Advice作用范围？

Spring的@RestControllerAdvice是作用于整个类的注解，无法在同一个Advice类中为不同的@ExceptionHandler方法单独设置生效范围。要实现你的需求，需要拆分出两个独立的Advice类，分别对应全局范围和特定包范围的异常处理。

优先方案：按特定包（含子包）限制范围 #

直接创建一个仅针对目标包的Advice类，利用@RestControllerAdvice的basePackages属性指定生效范围，该属性会自动包含指定包下的所有子包。

全局异常处理类（原全局生效的处理器） #

@RestControllerAdvice
@Slf4j
@AllArgsConstructor
public class GlobalExceptionHandler {
        
    // 该处理器在整个Spring项目中生效
    @ExceptionHandler({ MissingRequestHeaderException.class, BindException.class})
    public final ResponseEntity<ErrorDTO> exceptionBindRequestHandler(Exception ex) {
         // 业务逻辑实现
    }
}

特定包范围的异常处理类 #

@RestControllerAdvice(basePackages = "com.example.subpackage1")
@Slf4j
@AllArgsConstructor
public class Subpackage1ExceptionHandler {
        
    // 该处理器仅在com.example.subpackage1及其所有子包下的Controller中生效
    @ExceptionHandler({ ConnectException.class })
    public final ResponseEntity<ErrorDTO> connectExceptionHandler(Exception ex) {
        // 业务逻辑实现
    }
}

备选方案：按特定类列表限制范围（不推荐） #

如果必须指定具体类而非包，可以使用@RestControllerAdvice的assignableTypes属性手动指定目标Controller类，但这种方式需要维护类列表，不够便捷。

@RestControllerAdvice(assignableTypes = {TargetController1.class, TargetController2.class})
@Slf4j
@AllArgsConstructor
public class SpecificClassExceptionHandler {
        
    @ExceptionHandler({ ConnectException.class })
    public final ResponseEntity<ErrorDTO> connectExceptionHandler(Exception ex) {
        // 业务逻辑实现
    }
}

注意事项 #

• 若同一个异常被多个Advice类处理，Spring会优先选择范围更具体的Advice（比如指定类的Advice > 指定包的Advice > 全局Advice）。
• 确保拆分后的两个Advice类都能被Spring容器扫描到（放在Spring扫描路径下，或通过@ComponentScan指定扫描范围）。

内容的提问来源于stack exchange，提问作者Jason Chan