@ConditionalOnProperty的havingValue属性不生效问题排查

核心原因：@ConditionalOnProperty 注解位置错误 #

你把@ConditionalOnProperty加在了定时任务的run()方法上，但这个注解的作用是控制Bean的创建与否，而非单独控制某个方法是否执行。即使方法上加了该注解，只要ScheduleService这个类被Spring扫描并实例化（比如加了@Service/@Component注解），类中的@Scheduled方法依然会被注册并执行。

解决步骤 #

1. 将注解移至类级别
   如果ScheduleService是通过@Service/@Component注解注册的，直接把@ConditionalOnProperty加在类上，这样当属性为false时，整个Bean不会被创建，定时任务自然不会启动：

   @Service
   @ConditionalOnProperty(name = "board.qtalk.expiration", havingValue = "true")
   public class ScheduleService {
       @Scheduled(cron = "你的定时表达式")
       public void run() {
           // 定时任务逻辑
       }
   }
   

2. 若通过@Bean注册，加在Bean方法上
   如果ScheduleService是在配置类中通过@Bean方法创建的，把注解加在@Bean方法上：

   @Configuration
   public class ScheduleConfig {
       @Bean
       @ConditionalOnProperty(name = "board.qtalk.expiration", havingValue = "true")
       public ScheduleService scheduleService() {
           return new ScheduleService();
       }
   }
   

额外检查点 #

• 确认没有其他地方重复注册ScheduleService（比如多个配置类创建该Bean，或@ComponentScan范围过大导致重复扫描）。
• 核对属性名完全一致，避免拼写错误（比如board.qtalk.expiration写成board.qtalk.expire）。
• 确保@ConditionalOnProperty没有设置matchIfMissing = true（默认是false，若设置为true，属性不存在时也会创建Bean）。

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