如何调试Spring Boot自动配置中Bean缺失的问题？

一、先确认Bean的定义是否符合Spring要求 #

• 检查类注解：确保目标类标注了正确的注解，比如@Component、@Service、@Repository、@Controller；如果是自定义Bean，要在@Configuration类里的方法上标注@Bean。要是Spring Data Repository接口，得确保它继承了Repository、CrudRepository这类父接口，部分场景可能需要显式加@Repository注解。
• 检查包扫描范围：Spring Boot默认只扫描启动类所在包及其子包。如果Bean不在这个范围内，要么把启动类移到项目根包，要么在启动类上添加@ComponentScan(basePackages = "com.your.target.package")指定扫描路径。
• 检查条件注解：如果Bean上有@Conditional、@ConditionalOnProperty、@ConditionalOnClass这类条件注解，得验证条件是否满足。比如@ConditionalOnProperty(prefix = "my.service", name = "enabled", havingValue = "true")，要确认配置文件里对应的属性值是否正确。

二、查看Spring启动日志 #

• 开启调试级日志：在application.properties或application.yml里设置logging.level.org.springframework=DEBUG，启动应用后，搜索BeanDefinition、Creating bean、Skipping bean这些关键词，看看Spring有没有加载目标Bean的定义，以及有没有明确的跳过原因。
• 重点看错误日志：如果Bean创建失败，日志里会直接抛出异常，比如NoSuchBeanDefinitionException（依赖缺失）、循环依赖报错、构造函数参数不匹配等，这些都是最直接的排查线索。

三、用Spring Boot Actuator快速排查 #

• 启用beans端点：先在项目依赖里加Spring Boot Actuator，然后在配置文件里设置management.endpoints.web.exposure.include=beans。启动后访问/actuator/beans，查看返回的JSON内容，要是找不到目标Bean，说明Spring根本没注册它。

四、手动验证Bean的注册状态 #

• 添加Bean注册监听：在启动类里实现ApplicationListener<ContextRefreshedEvent>，重写onApplicationEvent方法，遍历applicationContext.getBeanDefinitionNames()，打印所有已注册的Bean名称，直接查看是否包含目标Bean。
• 用BeanFactoryPostProcessor检查：自定义一个BeanFactoryPostProcessor，在postProcessBeanFactory方法里调用beanFactory.containsBeanDefinition("yourBeanName")，确认Bean定义是否存在，还能查看Bean定义的详细配置。

五、排查依赖冲突或版本兼容问题 #

• 查看依赖树：用Maven命令mvn dependency:tree或者Gradle命令./gradlew dependencies，检查是否有Spring相关依赖的版本冲突，不同版本的依赖可能导致注解不被识别、自动配置失效。
• 验证第三方库兼容性：如果Bean来自第三方库，要确认该库和当前Spring Boot版本兼容，有些旧库可能不支持新版本Spring的自动配置规则，导致Bean无法被注册。

内容的提问来源于stack exchange，提问作者Jens Schauder