SpringBoot自动配置条件注解不生效，首要原因是自动配置类未被Spring Boot识别：需确认META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件存在且严格按行书写全限定名；其次检查各@ConditionalOn*注解对应条件是否满足，如类是否在classpath、属性值是否正确、同类型Bean是否已存在；最后通过-Ddebug、/actuator/conditions等手段定位失效阶段。
SpringBoot自动配置条件注解不生效，意味着你明明写了@ConditionalOnClass、@ConditionalOnProperty或@ConditionalOnMissingBean，但对应配置类或Bean就是没加载，日志里连影子都看不到，应用启动后功能缺失——这不是代码写错了，而是条件判断在某个环节被悄悄绕过或判定为假。
确认自动配置类是否进入候选列表
第一步不是看条件，而是看它有没有被Spring Boot“看见”。Spring Boot 3.x起不再读META-INF/spring.factories，改用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件注册候选配置类。
打开你的模块的src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports，检查里面是否**严格按行书写**了自动配置类的全限定名，例如：com.example.demo.config.MyAutoConfiguration。
【文件路径必须是斜杠分隔，不能是点号；文件名必须一字不差，大小写敏感；IDEA中若显示为META-INF.spring，说明文件夹被错误识别为包，需右键→"Mark Directory as"→"Resources Root"】
如果该文件不存在，或类名拼错、多空格、带分号，整个类都不会进入候选列表——后续所有条件注解都无从谈起。
验证条件注解是否满足
条件注解不生效，本质是“条件为假”。不同注解的判定逻辑完全不同，必须对症检查：
方法一：@ConditionalOnClass未生效 → 检查类是否真在classpath中
运行mvn dependency:tree | grep -i hikari（以HikariCP为例），确认依赖已拉取且版本兼容；不要只看pom.xml写了依赖，要确认jar包实际存在并被加载。若使用JDK17+，注意某些老库可能因模块系统被隔离，ClassLoader.getSystemClassLoader().loadClass("com.zaxxer.hikari.HikariDataSource")抛异常即说明不可见。
方法二：@ConditionalOnProperty未生效 → 检查属性是否存在且值为true
在启动类加@PostConstruct方法，打印environment.getProperty("myapp.feature.enabled")，确认返回值不是null或"false"；注意prefix和name拼接后必须与application.yml中key完全一致，包括大小写和中划线/下划线风格；若用@ConditionalOnProperty(prefix="myapp", name="feature.enabled")，配置项必须写成myapp.feature.enabled=true，而不是myapp.feature-enabled=true。
方法三：@ConditionalOnMissingBean未生效 → 检查同类型Bean是否已被提前注册
启用调试日志：logging.level.org.springframework.boot.autoconfigure=DEBUG，启动时搜索exclusion或skipping关键词；若看到Found beans of type [com.example.service.UserService] → @ConditionalOnMissingBean ignored，说明已有UserService Bean存在——可能是你在其他配置类里用@Bean声明了，也可能是组件扫描到了@Service类，还可能是父上下文已注入。
定位失效发生在哪个阶段
Spring Boot启动分四步：准备环境→创建容器→加载Bean定义→刷新容器。自动配置失效通常卡在第二或第三步。
第一步：启动时加JVM参数-Ddebug或配置debug=true，观察控制台是否输出Auto-configuration report区块；没有该区块，说明@EnableAutoConfiguration根本没触发，检查主类是否漏了@SpringBootApplication或被@ComponentScan错误覆盖。
第二步：若报告存在但某配置类显示Not matched:，展开看具体原因，如Did not match: - @ConditionalOnClass did not find required class 'javax.sql.DataSource'——这时就知道该去补依赖，而不是改代码。
第三步：若报告里该配置类显示Matched:，但运行时Bean仍不存在，说明条件满足但@Bean方法没执行——检查配置类是否被@Configuration或@AutoConfiguration正确标注，且没有被@SpringBootApplication(exclude=...)显式排除。
第四步：访问/actuator/conditions端点（需引入spring-boot-starter-actuator并开放该端点），直接查看每个自动配置类的匹配详情，比日志更结构化。
