使用@ConditionalOnProperty与@ComponentScan时Bean未找到问题求助

为什么@ComponentScan搭配@ConditionalOnProperty不生效？ #

Spring Boot中@ConditionalOnProperty标注在@Component类上时，生效时机早于配置属性的完全加载：

• @ComponentScan在Spring上下文初始化的早期阶段执行，此时Spring尚未完成所有环境属性的绑定与读取，car.enabled=true的配置还没被识别，条件判断结果为false，因此Car类不会被实例化为Bean。
• 而@Bean方法搭配@ConditionalOnProperty时，注解的条件判断会在Bean定义的后期处理阶段执行，此时所有配置属性已加载完成，能正确读取到car.enabled=true，所以Bean可以正常创建。

保留@ComponentScan的解决方法 #

方案1：优化@ConditionalOnProperty配置+提前加载属性（推荐） #

调整Car类的注解，同时添加配置属性扫描注解确保属性提前绑定：

@Component
@ConditionalOnProperty(name = "car.enabled", havingValue = "true", matchIfMissing = false)
public class Car {
    // 类实现代码
}

在主启动类或AppConfig类上添加@ConfigurationPropertiesScan，触发配置属性的提前加载：

@SpringBootApplication
@ComponentScan("base.package")
@ConfigurationPropertiesScan
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方案2：自定义Conditional条件类 #

自定义条件类手动读取环境属性，确保扫描阶段能获取到配置值：

public class CarEnabledCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Environment env = context.getEnvironment();
        return "true".equals(env.getProperty("car.enabled"));
    }
}

替换Car类上的@ConditionalOnProperty为自定义条件：

@Component
@Conditional(CarEnabledCondition.class)
public class Car {
    // 类实现代码
}

方案3：延迟Bean注册（进阶） #

通过实现BeanDefinitionRegistryPostProcessor接口，手动延迟Car类的Bean注册时机，直到配置属性加载完成。这种方式复杂度较高，仅推荐有Spring底层经验的开发者使用。

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