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

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 启动或 Actuator conditions 端点。
  • 条件报告有什么用?列出每个自动配置的匹配/未匹配原因。

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 定义顺序、属性值、应用类型和包扫描范围。

排查清单

  1. 启动加 --debug,查看 CONDITIONS EVALUATION REPORT。
  2. Actuator /actuator/conditions 看未匹配原因。
  3. 确认依赖是否在 classpath(OnClass)。
  4. 确认被依赖 Bean 是否已注册(OnBean 顺序)。
  5. 确认配置项 key/值是否精确匹配(OnProperty)。
  6. 确认配置类是否被扫描/导入。

追问

  • 条件报告显示 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
  • [ ] 能用条件报告排查问题