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,让依赖按约定装配,一条命令启动。
原理流程
- Boot 依赖
spring-boot-autoconfigure中的一批条件化@Configuration。 - 这些配置类按 classpath 上的依赖是否存在决定是否注册 Bean。
- 启动时仍由 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:没有DataSourceBean,启动会失败,需要自行定义数据源。 - 只在 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 引入。
原理流程
@AutoConfiguration元注解:@Configuration(proxyBeanMethods = false)+ 排序语义。- 选择器只把 imports 文件列出的类作为候选自动配置。
- 自动配置类排序后再解析,保证
@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 提供「默认值 + 可替换」模式的关键。
原理流程
- 用户
@Configuration注册自定义CacheManager。 - 自动配置解析到默认
@Bean方法,条件检查发现类型已存在。 - 默认 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 还是配置项不匹配。
原理流程
java -jar app.jar --debug启动。- 自动配置选择器把条件结果收集到
ConditionEvaluationReport。 - 日志输出报告:按自动配置类分组,列出 matched / unmatched 条件。
示例
Negative matches:
- DataSourceAutoConfiguration:
Bean type 'javax.sql.DataSource' was not found (OnBeanCondition)
常见误区
- 只看有没有报 Bean 缺失:不看具体条件类型,误判为 starter 没引入。
- 在生产开
--debug:报告信息量大且暴露配置细节,仅排查时本地/预发使用。
追问
- 报告能在代码里拿到吗?可注入
ConditionEvaluationReportBean 做测试断言或诊断输出。 - 条件未命中会报错吗?不会,未满足条件只是跳过装配;需要的 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 等包,不在业务包树下,因此必须通过选择器导入。两条通道互不替代。
原理流程
@ComponentScan扫描业务包,注册@Component/@Service/@Configuration。- 选择器读取 imports 文件,把第三方配置类加入候选。
- 两类配置最终都进入同一容器解析。
示例
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 注册顺序,最后用最小可复现工程验证。
原理流程
- 启动加
--debug,在 Negative matches 找到目标配置类。 - 看未命中条件:缺类 → 检查依赖与 exclusions;缺 Bean → 检查用户配置是否先注册;属性不匹配 → 核对配置键与值。
- 必要时打印条件评估明细或写测试断言 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或按名称注入;自动配置不应参与用户侧消歧。