Spring Boot多模块应用中Scheduler未按预期运行问题排查

针对你遇到的问题，核心是确保Spring能识别到调度类并触发其@Scheduled方法，以下是具体解决步骤：

• 确保调度类是Spring管理的Bean：给调度类添加@Component（或@Service、@Configuration等Spring stereotype注解），只有被Spring纳入容器管理的Bean，其@Scheduled方法才会被调度机制扫描处理。示例代码：

  @Component
  @EnableScheduling
  public class MyScheduler {
  
      @Scheduled(fixedRate = 5000)
      public void myScheduledTask() {
          // 你的任务执行逻辑
      }
  
      @PostConstruct
      public void init() {
          System.out.println("调度类已初始化");
      }
  }
  

• 正确放置@EnableScheduling注解：这个注解用来开启Spring的调度功能，建议直接放在Spring Boot的启动类（带@SpringBootApplication的类）上，或者放在一个被Spring扫描到的@Configuration类中。如果仅放在调度类上，需确保该调度类本身是@Configuration或被扫描到的组件，否则调度功能可能无法全局生效。

• 解决多模块组件扫描范围问题：如果调度类所在模块的包不在启动类的默认扫描范围内（启动类默认扫描自身包及其子包），需要在启动类上手动指定扫描路径：

  @SpringBootApplication(scanBasePackages = {"com.your.mainmodule", "com.your.schedulermodule"})
  public class MainApplication {
      public static void main(String[] args) {
          SpringApplication.run(MainApplication.class, args);
      }
  }
  

  或者使用@ComponentScan注解补充扫描范围。

• 检查调度开关配置：确认application.properties或application.yml中没有关闭调度功能，默认配置spring.scheduling.enabled=true，如果被设置为false会导致所有调度任务失效。

完成以上配置后，即使没有其他类注入该调度类，Spring容器启动时也会自动扫描并触发其@Scheduled方法。

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