罗罗编程学习记录
本页内容 展开查看

06.2.2.1 自动配置与条件装配

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.2 Java Spring 生态 / 06.2.2 Spring Boot

本节要解决的问题

  • Spring Boot 凭什么「引入依赖就生效」?自动配置从哪里被加载、按什么条件判定?
  • 条件注解在哪个阶段判断,为什么 @ConditionalOnBean 容易踩顺序坑?
  • 自定义 Starter 的自动配置类如何注册、排序与被用户覆盖?

版本前提:Spring Boot 3.x / Java 17+;涉及 Boot 2.x 差异处单独标注。

06.2.2.1-001 Spring Boot 和 Spring 是什么关系?

一句话结论

Spring Framework 提供 IoC、AOP、MVC、事务等基础能力;Spring Boot 是架在其上的脚手架与约定层,负责自动配置、起步依赖、内嵌容器与工程化能力,不替代 Spring。

概念解释

Spring 是能力底座,Bean 容器、面向切面、声明式事务、数据访问抽象都由它实现;Boot 不另起容器,核心仍是 Spring Framework。Boot 解决的是「组装成本」:减少 XML 与手工 @Bean,让依赖按约定装配,一条命令启动。

原理流程

  1. Boot 依赖 spring-boot-autoconfigure 中的一批条件化 @Configuration。
  2. 这些配置类按 classpath 上的依赖是否存在决定是否注册 Bean。
  3. 启动时仍由 Spring 容器完成 Bean 创建、代理与生命周期管理。

示例

Spring Framework:容器 / AOP / MVC / 事务 / 数据访问抽象
Spring Boot:自动配置 + Starter 聚合依赖 + 内嵌容器 + Actuator / 外部化配置 / 测试切片

常见误区

  • 认为 Boot 能脱离 Spring 使用:不能,核心容器仍是 Spring Framework。
  • 认为 Boot 一定用内嵌容器:可以打 war 部署外部容器,但主流方式是可执行 jar。

追问

  • Boot 与 Spring 版本如何对应?以官方兼容矩阵为准:Boot 3.x 对应 Spring Framework 6.x,Java 基线 17+。
  • Boot 相比 Spring 增加了什么?工程化约定:自动配置、外部化配置、Actuator、测试切片、可执行 jar 打包。

06.2.2.1-002 @SpringBootApplication 由哪些注解组成?

一句话结论

它是一个组合注解,等价于 @SpringBootConfiguration + @EnableAutoConfiguration + @ComponentScan,标记主配置类并开启组件扫描与自动配置。

概念解释

  • @SpringBootConfiguration:本质是 @Configuration,标记全局唯一的主配置类。
  • @EnableAutoConfiguration:开启自动配置,导入 AutoConfigurationImportSelector。
  • @ComponentScan:扫描启动类所在包及子包下的构造型注解。

示例

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}
注解 作用
@SpringBootConfiguration 标记主配置类,全局唯一
@EnableAutoConfiguration 导入自动配置选择器
@ComponentScan 扫描当前包及子包的 @Component

常见误区

  • 启动类放得太靠内导致扫不到外层包:默认只扫所在包的子树,启动类应放在最外层基础包。
  • 出现两个 @SpringBootConfiguration:启动期报错,要求唯一主配置类。

追问

  • 如何调整扫描范围?scanBasePackages、scanBasePackageClasses 或 excludeFilters。
  • proxyBeanMethods = false 有什么用?关闭主配置类的 CGLIB 增强(Lite 模式),加快启动;方法间 @Bean 调用不再返回代理单例。

06.2.2.1-003 Spring Boot 自动配置的原理是什么?

一句话结论

@EnableAutoConfiguration 导入选择器,从 AutoConfiguration.imports 读取候选配置类,经去重、排除与条件过滤后,作为 @Configuration 交给容器解析;条件不满足的配置类不生效。

概念解释

自动配置类本质是普通 @Configuration,通常标注大量 @ConditionalOnClass:只有 classpath 存在对应类时才生效,所以「引入 starter 就自动装配」。配置类里的 Bean 一般再标 @ConditionalOnMissingBean,允许用户自定义实现覆盖默认值。

原理流程

@EnableAutoConfiguration
  → @Import(AutoConfigurationImportSelector.class)
  → getAutoConfigurationEntry()
      ├─ getCandidateConfigurations()
      │    Boot 2.7+ / Boot 3:读取 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
      │    旧版本:读取 META-INF/spring.factories 的 EnableAutoConfiguration 键
      ├─ removeDuplicates / 排除 exclude
      ├─ 按 @Conditional 过滤(ConditionEvaluationReport 记录命中/未命中原因)
      └─ 返回 configClassNames
  → ConfigurationClassParser 按 @Configuration 解析
  → 其中的 @Bean 注册为 BeanDefinition

示例

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
spring:
  autoconfigure:
    exclude: org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

常见误区

  • 认为自动配置类会被 @ComponentScan 扫到:不会,它们在第三方 jar 的其他包下,靠 imports 文件注册。
  • 以为条件只看配置项:@ConditionalOnClass 在解析阶段判断(不真正加载类),其余条件在注册 BeanDefinition 时由 ConditionEvaluator 判断。

追问

  • spring.factories 还能用吗?Boot 3 仍兼容部分扩展点(监听器、初始化器),但自动配置已迁移到 AutoConfiguration.imports。
  • 自定义 starter 如何让配置类被加载?在 resources 下提供 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports,每行一个全限定类名。
  • 为什么配置类普遍 proxyBeanMethods = false?Lite 模式避免 CGLIB 代理,减少启动期增强;类内 @Bean 方法互调时注意不要假设返回同一代理实例。

06.2.2.1-004 常见条件注解有哪些?条件装配如何生效?

一句话结论

条件注解围绕「类是否存在、Bean 是否存在、配置项是否匹配、是否 Web 环境、资源是否存在」做判定;@ConditionalOnBean 依赖注册顺序,配置类之间要用排序注解显式定序。

概念解释

@Conditional 是基础接口,Boot 在其上扩展出面向类路径、Bean、属性、Web 应用类型、资源、表达式的条件实现。条件在配置类解析与 BeanDefinition 注册阶段求值,结果写入条件评估报告。

对比

注解 作用
@ConditionalOnClass classpath 存在指定类
@ConditionalOnMissingClass classpath 不存在指定类
@ConditionalOnBean 容器中存在指定 Bean
@ConditionalOnMissingBean 容器中不存在指定 Bean
@ConditionalOnProperty 配置项存在或等于指定值
@ConditionalOnWebApplication 当前是 Web 应用(SERVLET / REACTIVE)
@ConditionalOnNotWebApplication 非 Web 应用
@ConditionalOnResource 存在指定资源文件
@ConditionalOnExpression SpEL 表达式为真
@ConditionalOnSingleCandidate 指定类型只有一个或标注 @Primary

示例

@AutoConfiguration
@ConditionalOnClass(RedisTemplate.class)
@ConditionalOnProperty(prefix = "app.cache", name = "type", havingValue = "redis", matchIfMissing = false)
public class RedisCacheAutoConfiguration {
    @Bean
    @ConditionalOnMissingBean
    public CacheService cacheService(RedisTemplate<String, Object> template) {
        return new RedisCacheService(template);
    }
}

常见误区

  • @ConditionalOnBean 依赖 Bean 注册顺序:用户配置类可能先于自动配置解析,判定为「不存在」而漏装;官方建议只在自动配置类内部使用该条件。
  • matchIfMissing 默认值记反:默认为 false,配置缺失时条件不成立;需要「缺省开启」时显式设 true。

追问

  • 条件注解能标在 @Bean 方法上吗?能,方法级条件只影响该 Bean 是否注册。
  • 条件求值顺序?@ConditionalOnClass 在解析阶段判断(类加载前做类名检查),其余由 ConditionEvaluator 在注册 BeanDefinition 时判断。

06.2.2.1-005 如何排除某个自动配置?

一句话结论

三种途径:注解 exclude、配置项 spring.autoconfigure.exclude、移除对应 starter 依赖;排除后用 --debug 条件报告确认是否进入 Negative matches。

概念解释

排除的是「自动配置类」,不是容器能力。被排除后若仍想用其中的 Bean,需要自己定义 DataSource 等基础组件;excludeName 用字符串类名,避免编译期强依赖。

示例

// 1. 注解排除
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, SecurityAutoConfiguration.class})
# 2. 配置排除
spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
<!-- 3. 移除依赖,从根上不触发条件 -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

常见误区

  • 排除 DataSourceAutoConfiguration 后仍直接用 JdbcTemplate:没有 DataSource Bean,启动会失败,需要自行定义数据源。
  • 只在 yml 里写类名拼错:类名不存在时启动期提示无法解析,需核对全限定名。

追问

  • exclude 与 excludeName 区别?前者传 Class,编译期校验;后者传字符串,用于编译期不依赖该类的场景。
  • 怎么确认排除生效?启动加 --debug,在 ConditionEvaluationReport 的 Negative matches 中查看该配置类及未命中原因。

06.2.2.1-006 @AutoConfiguration 与普通 @Configuration 有什么区别?

一句话结论

@AutoConfiguration 是 Boot 为自动配置提供的专用注解,元注解包含 @Configuration,并通过 @AutoConfigureBefore/After/Order 支持配置类之间排序;普通 @Configuration 是用户业务配置。

概念解释

自动配置类要被选择器识别并参与条件过滤,因此专门标注 @AutoConfiguration;它默认 proxyBeanMethods = false(Lite),并允许声明与其他自动配置类的先后关系。业务配置类一般由组件扫描或显式 @Import 引入。

原理流程

  1. @AutoConfiguration 元注解:@Configuration(proxyBeanMethods = false) + 排序语义。
  2. 选择器只把 imports 文件列出的类作为候选自动配置。
  3. 自动配置类排序后再解析,保证 @ConditionalOnBean 等顺序敏感条件相对稳定。

示例

@AutoConfiguration(after = RedisAutoConfiguration.class)
@ConditionalOnClass(CacheManager.class)
public class CacheAutoConfiguration { }

常见误区

  • 把业务 @Configuration 写进 imports 文件:业务类应由扫描或 @Import 引入,放进自动配置目录会破坏约定。
  • 期望自动配置类之间靠包名顺序决定先后:不可靠,必须用 @AutoConfigureAfter/Before 显式声明。

追问

  • 自动配置类为什么默认 Lite?避免 CGLIB 增强,降低启动开销与代理数量。
  • 用户配置与自动配置冲突时谁赢?用户自定义 Bean 优先:自动配置用 @ConditionalOnMissingBean 让位。

06.2.2.1-007 AutoConfiguration.imports 文件是什么格式?

一句话结论

位于 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports,每行一个自动配置类全限定名,# 开头为注释;Boot 3 用它取代 spring.factories 中的自动配置键。

概念解释

该文件是选择器读取候选配置类的入口。每个 starter 模块在自己的 jar 里提供一份,多个 jar 的文件被合并读取。类名顺序与文件顺序一致,配合排序注解调整最终解析顺序。

示例

# META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
com.example.my.MyAutoConfiguration
com.example.my.RedisClientAutoConfiguration

常见误区

  • 包目录写错:文件必须放在 META-INF/spring/org.springframework.boot.autoconfigure/ 下,少一层目录选择器就读不到。
  • 类名写成简单名:必须是全限定类名,且类要在 jar 的 classpath 上可加载。

追问

  • 一个 imports 文件能写多少类?可以写多个;建议按能力拆分配置类,便于条件隔离。
  • Boot 2.7 之前用什么?META-INF/spring.factories 中 org.springframework.boot.autoconfigure.EnableAutoConfiguration 键;升级 Boot 3 需迁移到 imports 文件。

06.2.2.1-008 @ConditionalOnMissingBean 为什么能让用户覆盖默认实现?

一句话结论

默认 Bean 注册时检查容器是否已存在同类型 Bean;存在则不注册默认实例,用户自定义的 Bean 因此优先成为容器中该类型的唯一实现。

概念解释

该条件在 BeanDefinition 注册阶段求值。用户配置类通常先于自动配置被解析,所以先注册的自定义 Bean 会被条件识别为「已存在」,默认配置让位。这是 starter 提供「默认值 + 可替换」模式的关键。

原理流程

  1. 用户 @Configuration 注册自定义 CacheManager。
  2. 自动配置解析到默认 @Bean 方法,条件检查发现类型已存在。
  3. 默认 BeanDefinition 被跳过,容器保留用户实现。

示例

@Bean
@ConditionalOnMissingBean
public CacheManager cacheManager(RedisTemplate<String, Object> redis) {
    return new RedisCacheManager(redis);
}

常见误区

  • 按类型匹配时忽略泛型/Bean 名称差异:条件默认按类型匹配,同类型多个 Bean 时要看 @ConditionalOnSingleCandidate 语义。
  • 在用户类上也加 @ConditionalOnMissingBean:用户类不需要让位,加了反而可能被默认值抢先。

追问

  • 条件按类型还是按名称?默认按类型;可通过 value / type / name 指定。
  • 为什么有时默认 Bean 没被跳过?解析顺序导致用户 Bean 尚未注册,或类型/泛型不匹配,需要调整配置类顺序或改用显式注入。

06.2.2.1-009 自动配置类为什么普遍用 proxyBeanMethods = false?

一句话结论

Lite 模式下配置类不生成 CGLIB 子类,@Bean 方法直接调用返回新对象,启动更快、代理更少;代价是方法间互调不能靠代理返回单例。

概念解释

Full 模式(proxyBeanMethods = true)下配置类被 CGLIB 增强,@Bean 方法互相调用时被拦截并返回容器单例;Lite 模式不增强,适合自动配置这种「方法之间很少互调」的场景。

对比

模式 代理 方法互调 启动开销 典型场景
Full(true) CGLIB 子类 拦截返回单例 较高 业务配置、方法间互调多
Lite(false) 不增强 直接 new 较低 自动配置、无互调配置

示例

@AutoConfiguration(proxyBeanMethods = false)
public class HttpClientsAutoConfiguration {
    @Bean
    public RestClient restClient() { return RestClient.builder().build(); }
}

常见误区

  • Lite 模式下在配置类里写 @Bean A a() { return new B(a()); }:a() 直接调用得到新实例,不是单例。
  • 以为 false 会影响 AOP 代理:不影响业务 Bean 上的 @Transactional、@Async 等代理机制。

追问

  • 主配置类能关掉代理吗?@SpringBootApplication(proxyBeanMethods = false) 可以,但要确认没有配置类方法互调依赖。
  • 什么情况必须 Full?配置类方法间相互引用并希望共享单例时,保留默认 true。

06.2.2.1-010 ConditionEvaluationReport 怎么看配置为什么没生效?

一句话结论

启动加 --debug 打印条件评估报告,Positive matches 列出生效配置,Negative matches 列出未生效配置及未命中的具体条件;这是排查「我的 Bean 为什么没装上」的第一手段。

概念解释

报告记录每个候选自动配置类的条件求值结果:命中的类与方法出现在 Positive matches,未命中的出现在 Negative matches,并注明是缺少类、缺少 Bean 还是配置项不匹配。

原理流程

  1. java -jar app.jar --debug 启动。
  2. 自动配置选择器把条件结果收集到 ConditionEvaluationReport。
  3. 日志输出报告:按自动配置类分组,列出 matched / unmatched 条件。

示例

Negative matches:
  - DataSourceAutoConfiguration:
      Bean type 'javax.sql.DataSource' was not found (OnBeanCondition)

常见误区

  • 只看有没有报 Bean 缺失:不看具体条件类型,误判为 starter 没引入。
  • 在生产开 --debug:报告信息量大且暴露配置细节,仅排查时本地/预发使用。

追问

  • 报告能在代码里拿到吗?可注入 ConditionEvaluationReport Bean 做测试断言或诊断输出。
  • 条件未命中会报错吗?不会,未满足条件只是跳过装配;需要的 Bean 缺失会在后续注入点报错。

06.2.2.1-011 @EnableConfigurationProperties 与自动配置怎么配合?

一句话结论

自动配置类用 @EnableConfigurationProperties(XxxProperties.class) 把配置属性类注册为 Bean,配合 @ConfigurationProperties 完成松散绑定;也可用 @ConfigurationPropertiesScan 批量扫描。

概念解释

配置属性类本身只是数据载体,需要被纳入容器才能注入到 @Bean 方法。自动配置通常在类上声明启用哪个属性类,starter 使用者无需手工注册。

示例

@AutoConfiguration
@EnableConfigurationProperties(MyClientProperties.class)
public class MyClientAutoConfiguration {
    @Bean
    @ConditionalOnMissingBean
    public MyClient myClient(MyClientProperties props) {
        return new MyClient(props.getEndpoint(), props.getTimeout());
    }
}
@ConfigurationProperties(prefix = "my.client")
public record MyClientProperties(String endpoint, Duration timeout) { }

常见误区

  • 属性类只加 @ConfigurationProperties 不加注册方式:不会成为 Bean,注入时报缺 Bean。
  • 把属性类当 @Component 扫描:Boot 3 推荐 @EnableConfigurationProperties 或 @ConfigurationPropertiesScan,避免依赖包位置。

追问

  • 三种注册方式区别?@EnableConfigurationProperties 显式点名;@ConfigurationPropertiesScan 扫描指定包;@Component 方式依赖组件扫描路径。
  • 属性校验在哪做?属性类上配合 @Validated 与 JSR-303 注解,绑定失败即启动报错。

06.2.2.1-012 自动配置类之间如何排序?

一句话结论

用 @AutoConfigureAfter / @AutoConfigureBefore / @AutoConfigureOrder 声明相对顺序;排序保证条件敏感的配置类按预期先后解析,避免靠包名或文件顺序侥幸。

概念解释

@ConditionalOnBean 等条件依赖 Bean 注册先后,配置类若乱序,先解析的一方看不到后注册的 Bean。排序注解把自动配置的依赖关系显式化,选择器据此重排候选集合。

示例

@AutoConfiguration
@AutoConfigureAfter(RedisAutoConfiguration.class)
public class CacheAutoConfiguration { }

常见误区

  • 用 @Order 代替自动配置排序:@Order 用于 Bean 或监听器顺序,自动配置类间关系应使用专用注解。
  • 循环依赖的排序:A after B、B after A 会形成环,启动期按冲突处理,需梳理依赖方向。

追问

  • 排序作用在哪个阶段?选择器返回候选后、配置类解析前完成排序。
  • 与用户配置的关系?排序只在自动配置集合内部生效;用户配置仍先解析并优先于默认 Bean。

06.2.2.1-013 @ConditionalOnWebApplication 如何判定应用类型?

一句话结论

按 classpath 与环境推断 Servlet 型、Reactive 型或非 Web 应用;可指定 SERVLET / REACTIVE 精确匹配,用于隔离 Web 专用 Bean。

概念解释

WebApplicationType 由 SpringApplication 推断:存在 Servlet MVC 且非 WebFlux 为 SERVLET;存在 WebFlux 为 REACTIVE;都没有为 NONE。条件据此决定 Web 相关自动配置是否生效。

示例

@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
@AutoConfiguration
public class ServletSessionAutoConfiguration { }

常见误区

  • SERVLET 与 REACTIVE 配置混装:同一应用同时引入两套 Web 依赖时类型推断可能不符合预期,应按需排除 starter。
  • 普通命令行应用期望注册 Web Bean:类型为 NONE 时 Web 条件不成立。

追问

  • 如何强制指定应用类型?SpringApplication.setWebApplicationType(WebApplicationType.REACTIVE) 或主类实现对应接口。
  • 条件能判断非 Web 环境吗?@ConditionalOnNotWebApplication。

06.2.2.1-014 条件注解放类上和放 @Bean 方法上有什么区别?

一句话结论

类上条件控制整个配置类是否解析;方法上条件只控制该 BeanDefinition 是否注册,类内其他 Bean 不受影响。

概念解释

类级条件不满足时整个配置类被跳过;方法级条件在类已解析的前提下逐个判定,适合「同一配置类里按条件提供不同实现」的场景。

示例

@AutoConfiguration
public class ClientsAutoConfiguration {
    @Bean
    @ConditionalOnMissingBean
    public ClientA clientA() { return new ClientA(); }

    @Bean
    @ConditionalOnProperty(name = "client.b.enabled", havingValue = "true")
    public ClientB clientB() { return new ClientB(); }
}

常见误区

  • 方法级条件写在返回类型不匹配的 Bean 上:条件按方法返回类型或指定类型判定,类型不一致会失效。
  • 类级条件不满足仍期望方法被注册:类被整体跳过,方法条件不再求值。

追问

  • 方法上能用 @ConditionalOnClass 吗?能,作用于该 Bean 的类路径条件判断。
  • 条件注解能否叠加?可以,多个条件默认 AND 关系,全部满足才生效。

06.2.2.1-015 自动配置与组件扫描的边界在哪里?

一句话结论

业务 Bean 靠 @ComponentScan 扫描启动类子包;自动配置类在第三方 jar 的其他包下,由 imports 文件显式导入,不依赖扫描路径。

概念解释

组件扫描只覆盖启动类所在包树;starter 的自动配置类位于 org.springframework.boot.autoconfigure 等包,不在业务包树下,因此必须通过选择器导入。两条通道互不替代。

原理流程

  1. @ComponentScan 扫描业务包,注册 @Component/@Service/@Configuration。
  2. 选择器读取 imports 文件,把第三方配置类加入候选。
  3. 两类配置最终都进入同一容器解析。

示例

com.example.app.Application        ← 扫描起点
com.example.app.service.*          ← 组件扫描覆盖
org.springframework.boot.autoconfigure.jdbc.*  ← 自动配置导入,不被扫描覆盖

常见误区

  • 把自动配置类放到业务包里指望被扫到:能扫到但违反约定,且不再享受条件装配与选择器排序。
  • 启动类包写错导致业务 Bean 漏扫:扫描范围是包树,包名层级要与代码结构一致。

追问

  • 扫描范围过大有什么代价?扫描包越宽,候选类越多,启动解析与条件评估成本上升,还可能误装配。
  • 如何排除扫描中的特定类?excludeFilters。

06.2.2.1-016 引入一个 starter 后 Bean 是怎么被自动注册的?

一句话结论

starter 只聚合依赖;真正装配由 autoconfigure 模块的条件配置类完成:类路径出现对应库 → @ConditionalOnClass 命中 → 默认 Bean 在 @ConditionalOnMissingBean 下注册。

概念解释

starter 与自动配置通常拆成两个模块:xxx-spring-boot-starter(依赖聚合)和 xxx-spring-boot-autoconfigure(配置类与 imports)。使用者引入 starter 即传递引入 autoconfigure,容器按条件装配。

示例

spring-boot-starter-data-redis
  └─ 依赖 spring-boot-autoconfigure 中的 RedisAutoConfiguration
       @ConditionalOnClass(RedisOperations.class)
       @Bean @ConditionalOnMissingBean RedisTemplate / RedisConnectionFactory

常见误区

  • 以为 starter 本身写了 Bean 逻辑:starter 多数只是 pom 聚合,装配在 autoconfigure 模块。
  • 引入依赖但没有对应自动配置:第三方库未提供 imports 文件,需要手工写配置类。

追问

  • 怎么看某个 starter 带来哪些依赖?mvn dependency:tree 或 IDE 依赖面板。
  • 自动注册的连接工厂可改吗?可以:提供同类型自定义 Bean 覆盖,或通过 spring.redis.* 属性调整参数。

06.2.2.1-017 条件不匹配时如何系统化调试?

一句话结论

先看 --debug 条件报告定位未命中条件类型,再核对 classpath(依赖是否引入/被排除)、配置项取值、Bean 注册顺序,最后用最小可复现工程验证。

原理流程

  1. 启动加 --debug,在 Negative matches 找到目标配置类。
  2. 看未命中条件:缺类 → 检查依赖与 exclusions;缺 Bean → 检查用户配置是否先注册;属性不匹配 → 核对配置键与值。
  3. 必要时打印条件评估明细或写测试断言 Bean 是否存在。

示例

java -jar app.jar --debug
# 搜索 DataSourceAutoConfiguration / OnClassCondition / OnBeanCondition

常见误区

  • 直接改代码重试而不看报告:定位慢,且容易误删正确条件。
  • 忽略依赖被传递排除:starter 引入了,但某层 exclusions 把关键库去掉,类路径条件不成立。

追问

  • 测试里怎么断言自动配置生效?@SpringBootTest 注入目标 Bean,或用 ApplicationContextRunner 加载指定配置断言。
  • 条件报告能否导出文件?可在测试中导出报告,或接入诊断端点查看容器 Bean。

06.2.2.1-018 Boot 2 到 3 自动配置注册文件如何迁移?

一句话结论

把 spring.factories 中 EnableAutoConfiguration 键下列出的类,迁移到 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports,每行一个全限定类名;其他扩展点(监听器、初始化器)仍可用 spring.factories。

概念解释

Boot 2.7 起引入新 imports 文件并兼容旧键,Boot 3 自动配置只认 imports 文件。迁移时按模块整理配置类,删除 factories 中的自动配置键,保留 ApplicationContextInitializer、ApplicationListener 等条目。

示例

# 旧:META-INF/spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.example.MyAutoConfiguration

# 新:META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
com.example.MyAutoConfiguration

常见误区

  • 只删 factories 不建 imports:配置类不再被选择器读取,Bean 全部缺失。
  • 把监听器条目也迁走:监听器、初始化器的注册仍走 factories 或对应新接口,不要误删。

追问

  • 迁移后如何验证?启动 --debug 看 Positive matches 是否出现自定义配置类。
  • Boot 2.7 能否双写?可以过渡期同时保留,3.x 移除旧键。

06.2.2.1-019 Full 与 Lite 配置类在实际编码中怎么选?

一句话结论

配置类方法间很少互调用 Lite;需要在配置类里通过方法共享单例时用 Full;自动配置一律 Lite(@AutoConfiguration 默认)。

概念解释

Full 模式下 CGLIB 拦截 @Bean 方法调用,保证拿到容器单例;Lite 模式直接构造对象。选择取决于配置类内部是否存在方法互调以及是否需要单例共享。

对比

场景 推荐模式 原因
自动配置类 Lite 方法间基本不互调,减少代理
业务配置、Bean 间方法引用 Full 依赖方法调用返回单例
简单工具配置 Lite 亦可 无互调需求时可关闭代理

示例

// Full:b() 方法内调用 a() 拿到的是容器单例
@Configuration
public class AppConfig {
    @Bean A a() { return new A(); }
    @Bean B b() { return new B(a()); }
}

常见误区

  • Lite 下默认方法互调返回单例:实际每次调用都是新对象,行为与 Full 不同。
  • 所有配置类都保留 Full:不必要的 CGLIB 子类增加启动时间与元空间占用。

追问

  • 如何在测试中判断是否被代理?查看 Bean 类型是否为 $$EnhancerByCGLIB$$ 子类。
  • 关闭代理后 @Bean 互相调用怎么改?改为构造器/方法参数注入,由容器传单例。

06.2.2.1-020 自动配置覆盖用户配置的反例有哪些?

一句话结论

默认配置应通过 @ConditionalOnMissingBean 让位;反例是默认 Bean 无条件注册、覆盖用户实现,或条件按错误类型匹配导致用户 Bean 失效。

概念解释

starter 的职责是提供可替换的默认值。若默认 @Bean 不加缺失条件,用户自定义实现会与默认实例冲突或被覆盖,违背「约定优先、可定制」的设计。

常见误区

  • 默认 Bean 直接无条件注册:容器中同类型出现两个 Bean,按 @Primary/名称抉择,行为不确定。
  • @ConditionalOnMissingBean 写成按名称匹配,用户换名即失效;优先按类型匹配。

示例

// 正确:用户未定义时才提供默认
@Bean
@ConditionalOnMissingBean
public CacheManager defaultCacheManager() { return new CaffeineCacheManager(); }

追问

  • 用户想强制使用默认实现怎么办?显式声明依赖默认 Bean,不要靠「默认覆盖用户」。
  • 同类型多个 Bean 如何消歧?@Primary、@Qualifier 或按名称注入;自动配置不应参与用户侧消歧。