Docker容器中Spring Boot的@ConditionalOnBean失效引发Bean找不到报错

针对你遇到的Docker环境下@ConditionalOnBean失效、Spring尝试创建TestController导致依赖缺失的问题，结合Spring Boot 2.7.2的特性，可能的原因及解决方法如下：

可能的原因及对应解决步骤 #

1. 组件扫描范围不匹配 #

本地IntelliJ可能自动扫描了所有源码包，但打包后Spring的组件扫描范围未覆盖TestProvider所在包。

• 检查主启动类的@ComponentScan注解，确保其basePackages包含TestController和TestProvider的所在包。例如：

  @SpringBootApplication
  @ComponentScan(basePackages = {"com.yourpackage.controller", "com.yourpackage.provider"})
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

• 确认TestProvider类上添加了@Component/@Service等组件注解，否则Spring无法将其识别为Bean。

2. @ConditionalOnBean的时机问题 #

直接在TestController类上添加@ConditionalOnBean时，Spring在扫描到控制器类的阶段就会进行条件判断，此时TestProvider的Bean可能还未完成注册（比如TestProvider是通过第三方配置、延迟初始化或其他后置逻辑创建的）。

• 改为通过配置类注册TestControllerBean，将@ConditionalOnBean添加到@Bean方法上，确保条件判断在TestProviderBean完全创建后执行：

  @Configuration
  public class ControllerConfiguration {
      @Bean
      @ConditionalOnBean(TestProvider.class)
      public TestController testController(TestProvider testProvider) {
          return new TestController(testProvider);
      }
  }
  

  同时移除TestController类上的@RestController/@Controller和@ConditionalOnBean注解，避免Spring自动扫描创建该Bean。

3. Docker打包时遗漏类文件 #

本地开发时TestProvider存在于源码中，但打包过程中可能因配置问题未将其包含进Jar包。

• 解压Docker中使用的Jar包，或执行命令jar tf your-application.jar，检查TestProvider.class文件是否存在于对应路径下。
• 检查Maven/Gradle的打包配置，确保TestProvider所在模块被正确引入，且未被标记为test范围（若在主源码目录下）。

4. 环境配置差异 #

本地与Docker环境的配置文件不一致，导致TestProvider的Bean创建条件未满足。

• 检查TestProvider类是否带有@ConditionalOnProperty、@Profile等条件注解，确认Docker环境的配置文件（如application.yml/application.properties）中对应的属性或Profile已正确配置。
• 对比本地和Docker的配置，确保所有触发TestProviderBean创建的条件在Docker环境中都成立。

5. 日志排查 #

开启Spring上下文的DEBUG日志，查看Bean创建和条件判断的详细过程：

• 在Docker启动命令中添加参数：--logging.level.org.springframework.context.annotation=DEBUG
• 查看日志中关于TestProviderBean是否被注册，以及TestController的条件匹配结果，定位具体的判断逻辑问题。

内容的提问来源于stack exchange，提问作者Mikkel Løkke