Spring Boot2.7.1打jar包后@Scheduled定时任务偶发跳过执行问题

核心原因 #

Spring Boot 默认的 @EnableScheduling 配置会创建一个单线程的调度线程池，所有被 @Scheduled 标记的定时任务共用这唯一的一个工作线程，这是90%以上同类定时任务偶发不执行问题的根源。
你的场景里本地启动正常、jar包部署才出问题，本质是本地环境没有生产环境的网络波动、数据量增长、资源锁竞争等情况，任务都能快速执行完释放线程；而部署环境下只要任意一个定时任务出现长时间阻塞（比如REST调用没设超时卡住、数据库锁等待、IO阻塞），就会一直占住这个唯一的调度线程，后续所有到触发点的任务都无法被调度执行，直到阻塞任务自行释放线程，这也完全符合你描述的“偶发跳过、之后自动恢复”的现象。

其他次要排查点 #

• 时区不匹配：你的cron表达式没有手动指定zone属性，默认读取JVM运行时的默认时区，如果服务器时区和预期不一致、或者开启了NTP同步偶发时间跳变，也可能导致触发时间异常，这类问题概率较低。
• cron表达式语法无误：Spring原生cron不需要像Quartz那样在日/周字段互斥时填?，你写的0 5 12 * * * 确实代表每天12点05分触发，不存在语法错误导致的偶发不触发问题。

修复步骤 #

1. 替换默认单线程调度池，自定义线程池配置
   新增配置类，设置足够的核心线程数，避免任务之间互相阻塞：

@Configuration
public class ScheduleConfig {
    @Bean
    public TaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
        // 线程数设为定时任务总数+2个冗余即可，你有3个任务设5个足够
        taskScheduler.setPoolSize(5);
        taskScheduler.setThreadNamePrefix("biz-schedule-");
        // 应用关闭时等待定时任务执行完再退出，避免任务被强制中断
        taskScheduler.setWaitForTasksToCompleteOnShutdown(true);
        taskScheduler.setAwaitTerminationSeconds(60);
        return taskScheduler;
    }
}

2. 给所有阻塞操作加超时限制
   所有定时任务内的REST API调用、数据库查询、缓存操作都必须设置合理的连接、读取超时，禁止出现无限等待的逻辑，从根源避免线程被长时间占住。

3. 补全任务监控日志+异常捕获
   每个定时任务添加入口、出口日志，记录执行耗时，外层捕获所有异常打印堆栈，方便后续定位阻塞点：

@Service
public class YourScheduleClass {
    // 明确指定时区，避免JVM/服务器时区不一致问题
    @Scheduled(cron = "0 5 12 * * *", zone = "Asia/Shanghai")
    public void yourFunction() {
        long startTime = System.currentTimeMillis();
        // 替换成你项目实际使用的日志门面
        System.out.println("任务xxx开始执行");
        try {
            // 你的业务逻辑
        } catch (Exception e) {
            System.out.println("任务xxx执行异常：" + e);
        } finally {
            System.out.printf("任务xxx执行结束，耗时%dms%n", System.currentTimeMillis() - startTime);
        }
    }
}

4. 排查服务器基础配置
   确认部署服务器的时区配置和预期一致，NTP时间同步服务运行正常，不存在偶发的时间跳变、夏令时自动切换问题。

内容的提问来源于stack exchange，提问作者Mhamad jawad al hajjar