自定义@ControllerAdvice全局异常处理器Starter的自动配置疑问

核心结论 #

把@ControllerAdvice类加入spring.factories不是冗余操作，@ConditionalOnMissingBean本身无法单独让Spring识别并加载这个类，必须结合spring.factories的配置才能实现自动注册的效果。

具体解释 #

1. Spring Boot自动配置的加载逻辑
   Spring Boot的EnableAutoConfiguration机制，会读取spring.factories中org.springframework.boot.autoconfigure.EnableAutoConfiguration对应的类列表，这些类会被自动配置处理器加载并注册到Spring容器中。
   官方文档提到的“包含@Configuration类”是最常见的场景，但并非强制要求——只要是Spring能够识别的Bean类（比如带@Component、@ControllerAdvice这类派生注解的类），都可以放在这个列表里，Spring Boot会负责将其注册为容器中的Bean。

2. @ControllerAdvice的本质
   @ControllerAdvice本身是@Component的派生注解，意味着被它标注的类本身就是一个Spring Bean。但如果不通过spring.factories将其加入自动配置候选列表，Spring默认不会主动扫描自定义Starter中的这个类（除非用户在业务项目中手动配置扫描该包，但这违背了Starter“自动配置”的设计初衷）。

3. @ConditionalOnMissingBean的作用
   @ConditionalOnMissingBean(annotation = [ControllerAdvice::class])的作用是条件判断：只有当Spring容器中不存在任何带有@ControllerAdvice注解的Bean时，才会注册当前这个异常处理器类。但前提是，这个类必须先被Spring加载到，才能触发这个条件判断——而让Spring自动加载它的关键，就是把它加入spring.factories的EnableAutoConfiguration列表。

示例代码的逻辑验证 #

你给出的示例代码：

@ControllerAdvice
@ConditionalOnMissingBean(annotation = [ControllerAdvice::class])
class ExceptionHandler {
  ...
}

配合spring.factories中的配置：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  test.configuration.controller.ExceptionHandler

这个逻辑是完全正确的：

• Spring Boot启动时，通过自动配置机制加载ExceptionHandler类
• 触发@ConditionalOnMissingBean检查容器中是否已有自定义的@ControllerAdvice Bean
• 如果没有，就将这个Starter提供的异常处理器注册到容器中；如果有，则跳过注册，优先使用用户自定义的实现

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