06.2.1.7 条件装配与注解
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.2 Java Spring 生态 / 06.2.1 Spring Framework
本节要解决的问题
- Spring Boot 怎么做到“引入依赖就自动配置,没引入就跳过”?
@ConditionalOnMissingBean为什么能让用户自定义覆盖默认 Bean?- 条件不生效时怎么排查?
06.2.1.7-001 @Conditional 的原理是什么?
一句话结论
@Conditional 通过 Condition 接口判断是否注册 BeanDefinition;条件在配置解析阶段评估,不满足时该 Bean 根本不会注册。
展开原理
ConfigurationCondition区分REGISTER_BEAN与PARSE_CONFIGURATION两种阶段。ConditionEvaluator.shouldSkip读取注解上的Condition实现,调用matches。- Boot 的
@ConditionalOnClass等是组合条件(AllNestedConditions/AnyNestedCondition)。
示例
@Configuration
@ConditionalOnClass(name = "com.example.MissingLib")
public class LibAutoConfig { ... }
常见误区
- 条件不满足时不是“创建后不注册”,而是解析阶段就跳过,相关
@Bean方法不会执行。 - 条件评估依赖类路径/环境,运行环境变化会导致行为不同。
追问
- 为什么用字符串类名?避免类不存在时加载失败。
- 条件能依赖其他 Bean 吗?
@ConditionalOnBean依赖容器中已注册的定义,顺序敏感。
06.2.1.7-002 @ConditionalOnMissingBean 的作用是什么?
一句话结论
当容器中还没有指定类型/名称的 Bean 时才注册当前 Bean,用于“默认实现可被用户覆盖”。
示例
@Bean
@ConditionalOnMissingBean
public CacheService cacheService() {
return new LocalCacheService();
}
常见误区
- 它判断的是 BeanDefinition 是否已注册,不是实例是否已创建。
- 与
@ConditionalOnBean同时用可能因顺序导致意外结果。
追问
- 用户自定义 Bean 为什么能覆盖?用户配置先解析,默认自动配置后评估,发现已存在就跳过。
- 如何指定按名称判断?
@ConditionalOnMissingBean(name="cacheService")。
06.2.1.7-003 @ConditionalOnClass 与 @ConditionalOnBean 有什么区别?
一句话结论
OnClass 判断类路径是否存在某个类;OnBean 判断容器中是否已注册某个 Bean,前者不依赖容器状态,后者依赖解析顺序。
对比
| 注解 | 判断对象 | 典型用途 |
|---|---|---|
@ConditionalOnClass |
classpath | 依赖存在才装配 |
@ConditionalOnMissingClass |
classpath | 依赖不存在才装配 |
@ConditionalOnBean |
容器 BeanDefinition | 某能力已提供 |
@ConditionalOnMissingBean |
容器 BeanDefinition | 默认兜底 |
@ConditionalOnProperty |
配置项 | 开关 |
@ConditionalOnWebApplication |
应用类型 | Web 专属配置 |
常见误区
@ConditionalOnBean用在自动配置类上时,被依赖的 Bean 可能还没解析,导致条件永远不成立。- 类名写错不会报错,只会静默跳过。
追问
- 如何保证 OnBean 顺序?用
@AutoConfigureAfter/@AutoConfigureBefore。 - 条件注解能组合吗?可以,多个注解是“与”关系。
06.2.1.7-004 Spring Boot 自动配置的条件顺序如何保证?
一句话结论
通过 @AutoConfigureBefore、@AutoConfigureAfter、@AutoConfigureOrder 控制配置类顺序,再配合条件注解实现“先用户、后默认”。
展开原理
AutoConfigurationSorter读取注解,构建排序图。AutoConfigurationImportSelector过滤候选后按顺序导入。- 用户
@Configuration通常先于自动配置处理,因此OnMissingBean能看到用户定义。
示例
@AutoConfiguration(after = DataSourceAutoConfiguration.class)
@ConditionalOnBean(DataSource.class)
public class JdbcTemplateAutoConfiguration { ... }
常见误区
- 仅靠
@Order不能控制自动配置类顺序,必须用 AutoConfigure 系列。 - 循环依赖排序会报错或顺序不确定。
追问
- 如何查看实际生效的自动配置?
--debug启动或 Actuatorconditions端点。 - 条件报告有什么用?列出每个自动配置的匹配/未匹配原因。
06.2.1.7-005 @Profile 和条件注解有什么区别?
一句话结论
@Profile 是 Spring 框架提供的“按激活 profile 注册”的快捷方式,本质也是 @Conditional;Boot 更常用 @ConditionalOnProperty。
示例
@Configuration
@Profile("dev")
public class DevConfig { ... }
常见误区
@Profile只认spring.profiles.active/spring.profiles.default,不认任意配置项。- 多 profile 表达式(
dev & !test)支持有限,需查文档。
追问
- 测试里怎么激活 profile?
@ActiveProfiles("test")。 - 生产环境误激活 dev 配置会怎样?可能连测试库/打开调试端点,需配置审查。
06.2.1.7-006 @Import 会受条件注解影响吗?
一句话结论
会。被导入的配置类上的 @Conditional 仍会被评估;但 @Import 本身不做条件判断,不能按条件决定“是否导入”。
示例
@Configuration
@ConditionalOnProperty(name = "feature.x", havingValue = "true")
public class XConfig { ... }
@Configuration
@Import(XConfig.class)
public class AppConfig { ... }
常见误区
- 以为
@Import是强制加载,忽略被导入类上的条件。 - 在
@Import的类上写条件,只影响该类自身,不影响被导入类。
追问
- 想按条件导入多个类怎么办?用
ImportSelector返回不同类名。 @ComponentScan的类受条件影响吗?受,扫描到的候选仍会评估条件。
06.2.1.7-007 如何自定义一个 Condition?
一句话结论
实现 Condition(或 SpringBootCondition)并在 @Conditional 中引用;matches 返回 true 才注册。
示例
public class OnLinuxCondition implements Condition {
public boolean matches(ConditionContext ctx, AnnotatedTypeMetadata meta) {
return System.getProperty("os.name").toLowerCase().contains("linux");
}
}
@Configuration
@Conditional(OnLinuxCondition.class)
public class LinuxConfig { ... }
常见误区
matches会被多次调用,避免耗时操作。- 抛异常会被当作条件不匹配并记录,不会中断启动。
追问
- 如何输出条件判断日志?继承
SpringBootCondition并实现getMatchOutcome。 - 条件类能注入 Bean 吗?不能直接注入,只能通过
ConditionContext获取环境/注册表。
06.2.1.7-008 条件装配不生效怎么排查?
一句话结论
先看条件报告,再核对类路径、Bean 定义顺序、属性值、应用类型和包扫描范围。
排查清单
- 启动加
--debug,查看CONDITIONS EVALUATION REPORT。 - Actuator
/actuator/conditions看未匹配原因。 - 确认依赖是否在 classpath(
OnClass)。 - 确认被依赖 Bean 是否已注册(
OnBean顺序)。 - 确认配置项 key/值是否精确匹配(
OnProperty)。 - 确认配置类是否被扫描/导入。
追问
- 条件报告显示 matched 但 Bean 还是没有?可能被同名覆盖或懒加载。
- 本地能起、服务器不能起?环境变量/类路径差异。
06.2.1.7-009 @ConfigurationProperties 是怎么绑定的?
一句话结论
通过 ConfigurationPropertiesBindingPostProcessor 在 Bean 初始化前,把 Environment 中前缀匹配的属性按宽松绑定规则注入到对象的字段/setter。
示例
@ConfigurationProperties(prefix = "app.mail")
public record MailProps(String host, int port) {}
@EnableConfigurationProperties(MailProps.class)
@Configuration
public class MailConfig {}
常见误区
- 只写
@ConfigurationProperties不注册,属性不会绑定;需要@EnableConfigurationProperties、@Component或@ConfigurationPropertiesScan。 - 松散绑定支持
host-name→hostName,但拼错不会报错,只会为 null。
追问
- 如何做校验?加
@Validated+ JSR-303 注解。 - 和
@Value的区别?@Value单个注入、不支持复杂对象/元数据。
06.2.1.7-010 @EnableConfigurationProperties 与 @ConfigurationPropertiesScan 怎么选?
一句话结论
@EnableConfigurationProperties 精确注册指定类;@ConfigurationPropertiesScan 扫描包下所有 @ConfigurationProperties 类,适合类多时。
示例
@SpringBootApplication
@ConfigurationPropertiesScan("com.example.config")
public class App {}
常见误区
- 扫描范围过大导致意外绑定/启动变慢。
- 同时用
@Component和@EnableConfigurationProperties可能注册两次(通常不会,但要注意)。
追问
- 为什么推荐构造器绑定?不可变、易测试、避免 setter 副作用。
- 属性来源能加密吗?配置中心/环境变量,或自定义
PropertySource解密。
本节自检
- [ ] 能解释条件注解在哪个阶段生效
- [ ] 能说出
OnMissingBean的覆盖机制 - [ ] 能控制自动配置顺序
- [ ] 能自定义 Condition
- [ ] 能用条件报告排查问题