Spring Boot自动配置失效时，可通过DEBUG日志、--debug参数或/actuator/conditions端点定位条件不满足原因，如@ConditionalOnClass缺失类、@ConditionalOnMissingBean已存在Bean等。
当SpringBoot自动配置没有按预期生效，或某个配置类意外被跳过时，必须定位是哪个条件未满足——比如@ConditionalOnClass找不到类、@ConditionalOnMissingBean发现已有同类型Bean、或@ConditionalOnProperty读取的配置值不匹配。
启用DEBUG日志查看自动配置决策链
在application.properties中添加一行：
logging.level.org.springframework.boot.autoconfigure=DEBUG
重启应用，控制台会输出每一条自动配置类的评估过程。你会看到类似WebMvcAutoConfiguration matched或DataSourceAutoConfiguration did not match: @ConditionalOnClass did not find required class 'javax.sql.DataSource'这样的日志。注意：日志量极大，建议配合grep过滤关键词，例如grep "DataSource"。
使用--debug参数启动获取结构化报告
直接在IDE运行配置或命令行中添加--debug参数：
java -jar your-app.jar --debug
应用启动完成后，控制台末尾会输出一份清晰的CONDITIONS EVALUATION REPORT。报告分为positiveMatches（满足条件的配置类）和negativeMatches（被跳过的配置类），每个条目都注明具体失败原因，例如@ConditionalOnClass did not find required class 'redis.clients.jedis.Jedis'。这比纯DEBUG日志更聚焦，且无需额外依赖。
通过Actuator端点实时查看条件评估详情
方法一：添加Actuator依赖
在pom.xml中引入：
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency>
方法二：暴露conditions端点
在application.yml中配置：
management:<br> endpoints:<br> web:<br> exposure:<br> include: conditions
方法三：访问端点并解析结果
启动应用后，访问http://localhost:8080/actuator/conditions。返回的是JSON格式的完整评估树，包含所有上下文、每个自动配置类的正向/负向匹配项及对应条件注解的判定依据。注意：【该端点默认只对本地请求开放，生产环境需显式配置management.endpoints.web.cors.allowed-origins才能跨域访问】。
验证自定义Bean对自动配置的阻断效应
第一步：确认是否存在同类型Bean
在任意配置类或启动类中，注入ApplicationContext，调用getBeansOfType(DataSource.class)，打印返回的Map大小。若数量≥1，说明已有DataSource Bean存在。
第二步：检查Bean定义来源
观察该Bean是否由@Bean方法、@Component扫描、或第三方starter引入。Spring Boot一旦检测到任意DataSource类型的Bean，【无论其是否标注@Primary、名称为何、作用域如何，都会立即禁用DataSourceAutoConfiguration】。
第三步：临时排除干扰配置
在@SpringBootApplication上添加exclude = DataSourceAutoConfiguration.class，再启动并观察其他自动配置是否恢复——这是快速验证是否为“Bean冲突导致连锁失效”的最直接方式。
