对于最新的稳定版本,请使用 Spring Boot 3.5.5! |
任务执行和调度
在没有Executor
bean 时,Spring Boot 会自动配置AsyncTaskExecutor
.
启用虚拟线程时(使用 Java 21+ 和spring.threads.virtual.enabled
设置为true
) 这将是一个SimpleAsyncTaskExecutor
使用虚拟线程。
否则,它将是一个ThreadPoolTaskExecutor
具有合理的默认值。
无论哪种情况,自动配置的执行器都将自动用于:
-
异步任务执行 (
@EnableAsync
) -
Spring for GraphQL 的异步处理
Callable
控制器方法的返回值 -
Spring MVC 的异步请求处理
-
Spring WebFlux 的阻塞执行支持
如果您定义了自定义 自动配置的 |
如果多个 |
当ThreadPoolTaskExecutor
是自动配置的,线程池使用8个核心线程,可以根据负载增长和缩小。
这些默认设置可以使用spring.task.execution
命名空间,如以下示例所示:
-
Properties
-
YAML
spring.task.execution.pool.max-size=16
spring.task.execution.pool.queue-capacity=100
spring.task.execution.pool.keep-alive=10s
spring:
task:
execution:
pool:
max-size: 16
queue-capacity: 100
keep-alive: "10s"
这会将线程池更改为使用有界队列,以便当队列已满(100 个任务)时,线程池增加到最多 16 个线程。 池的收缩更加激进,因为线程在空闲 10 秒(而不是默认情况下的 60 秒)时被回收。
如果调度程序需要与计划任务执行相关联,也可以自动配置调度程序(使用@EnableScheduling
例如)。
如果启用了虚拟线程(使用 Java 21+ 和spring.threads.virtual.enabled
设置为true
) 这将是一个SimpleAsyncTaskScheduler
使用虚拟线程。
这SimpleAsyncTaskScheduler
将忽略任何与池相关的属性。
如果未启用虚拟线程,它将是一个ThreadPoolTaskScheduler
具有合理的默认值。
这ThreadPoolTaskScheduler
默认使用一个线程,可以使用spring.task.scheduling
命名空间,如以下示例所示:
-
Properties
-
YAML
spring.task.scheduling.thread-name-prefix=scheduling-
spring.task.scheduling.pool.size=2
spring:
task:
scheduling:
thread-name-prefix: "scheduling-"
pool:
size: 2
一个ThreadPoolTaskExecutorBuilder
bean,一个SimpleAsyncTaskExecutorBuilder
bean,一个ThreadPoolTaskSchedulerBuilder
bean 和SimpleAsyncTaskSchedulerBuilder
如果需要创建自定义执行程序或调度程序,则在上下文中可用。
这SimpleAsyncTaskExecutorBuilder
和SimpleAsyncTaskSchedulerBuilder
如果启用了 Bean(使用 Java 21+ 和spring.threads.virtual.enabled
设置为true
).