要让自定义 Starter 在 Spring Boot 4.6 中精准控制 Bean 注册时机，必须使用条件注解触发自动装配，并将自动配置类声明在 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件中，严格遵循路径、命名及大小写规范。
要让自定义 Starter 在 Spring Boot 4.6 中精准控制 Bean 的注册时机，必须正确使用条件注解触发自动装配，否则依赖缺失时仍会强行创建 Bean 导致启动失败或运行时异常。
理解自动装配的触发链条
Spring Boot 4.6 已完全弃用 META-INF/spring.factories，所有自动配置类必须声明在 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件中——该文件每行写一个全限定类名，顺序无关，但【文件路径和命名必须一字不差，大小写敏感】。
应用启动时，@EnableAutoConfiguration 触发 AutoConfigurationImportSelector，它通过 ImportCandidates.load(AutoConfiguration.class) 加载此文件内容，再逐个评估每个配置类上的 @Conditional 注解结果。
只有全部条件为 true 的配置类才会被纳入配置候选集，最终由 ConfigurationClassPostProcessor 执行 Bean 定义注册。
最常用条件注解实战写法
方法一：@ConditionalOnClass 控制类存在性依赖
在自动配置类上标注 @ConditionalOnClass(DataSource.class)，表示仅当项目 classpath 中存在 javax.sql.DataSource（或 Jakarta EE 对应类）时才加载该配置。若引入了 spring-boot-starter-jdbc，此条件自然满足；若未引入却强制加载，会导致 NoClassDefFoundError。
方法二：@ConditionalOnMissingBean 防止 Bean 冲突
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
在 @Bean 方法上添加 @ConditionalOnMissingBean(name = "myCacheManager")，确保用户未手动定义同名 Bean 时才创建默认实例。这一步不可省略，否则用户自定义的 CacheManager 会被覆盖。
方法三：@ConditionalOnProperty 按配置开关启用功能
写成 @ConditionalOnProperty(name = "custom.feature.enabled", havingValue = "true", matchIfMissing = false)。注意 matchIfMissing = false 是关键，默认值为 true，不显式设为 false 会导致配置项未声明时功能意外开启。
组合条件与自定义 Condition 的正确姿势
第一步：需要同时满足多个前提？不要嵌套多个 @ConditionalOnXXX 注解——Spring 不支持 AND 逻辑叠加，而是直接失效。
第二步：改用 @Conditional(MyCompositeCondition.class)，其中 MyCompositeCondition 实现 Condition 接口，在 matches() 方法内手动判断：context.getClassLoader().loadClass("com.example.Foo") != null 且 configurationProperties.getEnabled() 为 true。
第三步：将自定义 Condition 类放在自动配置模块的 src/main/java 下，确保能被类加载器找到；【不要放在 test 目录或 resources 下，否则运行时报 ClassNotFoundException】。
第四步：在自动配置类上使用该条件：@Conditional(MyCompositeCondition.class)，此时整个配置类的加载与否由你的 Java 代码逻辑决定。
