springboot自动配置静默失效的首要原因是autoconfiguration.imports文件路径或内容错误，导致配置类未进入候选列表；其次为条件注解不满足、被exclude排除、idea将meta-inf/spring误识别为包名等。
SpringBoot自动配置不生效却没有任何报错，说明Spring容器已安静跳过该配置类，既没加载Bean也没抛异常——这种“静默失效”最难定位，因为日志里找不到线索，控制台一片平静，但功能就是不工作。
确认自动配置类是否进入候选列表
第一步不是查代码，而是看Spring Boot到底有没有“看见”你的自动配置类。打开项目编译后的 target/classes/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（Maven）或 build/resources/main/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（Gradle），用文本编辑器直接打开它。
文件必须存在且内容为纯文本，每行一个全限定类名，例如：
com.example.config.MyAutoConfiguration
如果文件不存在、路径写错（比如写成 META-INF/spring.factories）、文件名多了一个字母、或者类名拼写错误（大小写/包名/类名任一字符出错），Spring Boot就根本不会把这个类加入候选列表，后续所有条件判断都无从谈起。
【文件路径和文件名必须一字不差：META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports】
验证条件注解是否满足
即使类进了候选列表，@ConditionalOnClass、@ConditionalOnMissingBean等注解也会把它拦在门外。最可靠的方式是加一行静态初始化日志：
在自动配置类顶部添加：
static { System.out.println(">>> MyAutoConfiguration candidate loaded"); }
重启应用，观察控制台是否有这行输出。如果有，说明类已被加载进JVM，但被条件注解过滤掉了；如果没有，问题一定出在上一步的imports文件或类路径上。
常见陷阱：@ConditionalOnClass要求类在**当前模块的classpath中存在**，而不是依赖模块里——比如你写了@ConditionalOnClass(RedisTemplate.class)，但只引入了spring-boot-starter-data-redis的API模块而非完整starter，RedisTemplate实际未加载，条件就不成立。
检查启动类是否排除了该配置
打开主启动类，搜索@SpringBootApplication注解的exclude属性：
方法一：直接查看注解参数
如果写成@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)，注意是否误用了通配符或全限定名错误。
方法二：全局搜索排除关键词
在IDE中全局搜索exclude =或@EnableAutoConfiguration，有些项目会把@EnableAutoConfiguration单独拆出来写，而exclude可能写在别的地方。
特别注意：exclude支持类数组，也支持字符串数组，例如excludeName = "org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration"——字符串形式容易拼错，且不会被IDE语法检查。
验证Bean是否真的注册成功
第一步：启动后访问/actuator/beans端点（需启用spring-boot-starter-actuator并配置management.endpoints.web.exposure.include=beans）。
第二步：在返回的JSON中搜索你的配置类名或预期的Bean名称（如myService、dataSource）。
第三步：如果完全搜不到，说明该Bean从未注册；如果搜到了但scope为singleton而dependencies为空，说明它被创建了但没被其他Bean引用，可能是条件未触发或依赖缺失导致其未被注入上下文。
这一步能绕过日志干扰，直接看到容器里真实存在的Bean快照。
排查IDEA项目结构导致的路径伪装
在IntelliJ IDEA中，右键点击META-INF文件夹 → “Show in Explorer”，观察实际磁盘路径。如果显示的是META-INF.spring这样的连字符命名，说明IDEA把点号当成了分隔符，自动将META-INF/spring识别为包名，导致资源文件未被打包进classes目录。
解决方法：关闭IDEA → 删除项目根目录下的.idea文件夹和*.iml文件 → 重新用IDEA打开项目（选择“Import project”而非“Open”）→ 确保META-INF/spring在Project视图中显示为普通文件夹，而非蓝色包图标。
这个坑在Spring Boot 3.x多模块项目中最常见，且毫无日志提示，文件看似存在，实则从未参与构建。
