Spring Boot 任务执行和调度中文文档

本文为官方文档直译版本。原文链接

引言

如果上下文中没有 Executor Bean，Spring Boot 会自动配置 AsyncTaskExecutor。如果启用了虚拟线程（使用 Java 21+，且 spring.threads.virtual.enabled 设置为 true），这将是一个使用虚拟线程的 SimpleAsyncTaskExecutor。否则，它将是一个具有合理默认值的 ThreadPoolTaskExecutor。无论哪种情况，自动配置的执行器都将自动用于以下用途：

• 异步任务执行（@EnableAsync）
• Spring for GraphQL 异步处理控制器方法的可调用返回值
• Spring MVC 的异步请求处理
• Spring WebFlux 的阻塞执行支持

如果您在上下文中定义了自定义执行器，常规任务执行（即 @EnableAsync）和 Spring for GraphQL 都将使用它。但是，Spring MVC 和 Spring WebFlux 支持只有在 AsyncTaskExecutor 实现（名为 applicationTaskExecutor）时才会使用它。根据您的目标安排，您可以将 Executor 更改为 AsyncTaskExecutor，或者同时定义一个 AsyncTaskExecutor 和一个封装自定义 Executor 的 AsyncConfigurer。
自动配置的 ThreadPoolTaskExecutorBuilder 可让您轻松创建实例，重现自动配置的默认功能。

自动配置 ThreadPoolTaskExecutor 时，线程池使用 8 个核心线程，可根据负载情况增减。这些默认设置可使用 spring.task.execution 命名空间进行微调，如下例所示：

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。否则，它将是一个具有合理默认值的 ThreadPoolTaskScheduler。
ThreadPoolTaskScheduler 默认使用一个线程，其设置可使用 spring.task.scheduling 命名空间进行微调，如下例所示：

spring:
  task:
    scheduling:
      thread-name-prefix: "scheduling-"
      pool:
        size: 2

如果需要创建自定义执行器或调度器，上下文中将提供 ThreadPoolTaskExecutorBuilder Bean、SimpleAsyncTaskExecutorBuilder Bean、ThreadPoolTaskSchedulerBuilder Bean 和 SimpleAsyncTaskSchedulerBuilder。如果启用了虚拟线程（使用 Java 21+ 并将 spring.threads.virtual.enabled 设为 true），SimpleAsyncTaskExecutorBuilder 和 SimpleAsyncTaskSchedulerBuilder Bean 将自动配置为使用虚拟线程。