Mastering Spring Boot 3 Scheduled Tasks: Thread Pools, Concurrency & Customization

1. Introduction

In Spring, scheduled tasks allow developers to execute specific operations at fixed times or intervals, such as automatic updates, data cleanup, or notifications.

The most common way is using the @Scheduled annotation, which can be placed on a method to define its execution schedule.

2. Using @Scheduled and Cron Expressions

The @Scheduled annotation supports fixed‑rate, fixed‑delay, and Cron expressions. Example using Cron to run every 5 seconds:

public class SchedulingService {
    // Every 5 seconds
    @Scheduled(cron = "0/5 * * * * ?")
    public void s() {
        System.out.printf("%s - 执行任务 task-1: %s%n",
            Thread.currentThread().getName(),
            new SimpleDateFormat("HH:mm:ss").format(new Date()));
        try { TimeUnit.SECONDS.sleep(3); } catch (InterruptedException e) { }
    }
}

Output shows the task runs as expected.

2.1 Multiple Tasks Concurrency Issue

Adding another task that runs every 2 seconds:

// Another scheduled task
@Scheduled(cron = "0/2 * * * * ?")
public void s2() {
    System.out.printf("%s - 执行任务 task-2: %s%n",
        Thread.currentThread().getName(),
        new SimpleDateFormat("HH:mm:ss").format(new Date()));
    try { TimeUnit.SECONDS.sleep(1); } catch (InterruptedException e) { }
}

Running both tasks reveals they share the same thread, causing unexpected behavior; you need to separate execution times or configure a thread pool.

2.2 Default Thread Pool

Spring registers a TaskScheduler or ScheduledExecutorService during container startup. If none is defined, it creates a single‑core thread pool with Integer.MAX_VALUE queue capacity.

2.3 Custom Thread Pool

You can provide your own TaskScheduler or ScheduledExecutorService bean, e.g.:

@Bean
public TaskScheduler taskScheduler() {
    ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
    scheduler.setPoolSize(2);
    scheduler.initialize();
    return scheduler;
}

Or configure the scheduler attribute on @Scheduled (available since Spring 6.1):

@Scheduled(cron = "0/5 * * * * ?", scheduler = "task1")

2.4 ThreadPoolTaskScheduler in Spring Boot

Spring Boot auto‑configures a ThreadPoolTaskScheduler bean. Its core pool size defaults to 1 (property spring.task.scheduling.pool.size).

@ConfigurationProperties("spring.task.scheduling")
public class TaskSchedulingProperties {
    private final Pool pool = new Pool();
    public static class Pool {
        private int size = 1;
    }
}

Therefore, when multiple scheduled tasks exist, you should increase the pool size via configuration or a custom bean to avoid contention.