对于最新的稳定版本,请使用 Spring Boot 3.4.0! |
任务执行和调度
在上下文中没有 Executor
bean 的情况下, Spring Boot 会自动配置AsyncTaskExecutor
。
启用虚拟线程(使用 Java 21+ 并设置为 )时,这将是使用虚拟线程的 SimpleAsyncTaskExecutor
。
否则,它将是具有合理默认值的 ThreadPoolTaskExecutor
。
在任何一种情况下,自动配置的执行程序都将自动用于:spring.threads.virtual.enabled
true
-
异步任务执行 (
@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+ 并设置为 ),这将是使用虚拟线程的 SimpleAsyncTaskScheduler
。
此 SimpleAsyncTaskScheduler
将忽略任何与池相关的属性。spring.threads.virtual.enabled
true
如果未启用虚拟线程,它将是具有合理默认值的 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