异步任务

SpringBoot 如何异步编程，老鸟们都这么玩的！#

飘渺Jam

链接

老鸟系列文章导读：

1. SpringBoot 如何统一后端返回格式？老鸟们都是这样玩的！

2. SpringBoot 如何进行参数校验？老鸟们都是这么玩的！

3. SpringBoot 如何生成接口文档，老鸟们都这么玩的！

4. SpringBoot 如何进行对象复制，老鸟们都这么玩的！

5. SpringBoot 生成接口文档，我用smart-doc

6. SpringBoot 如何进行限流？老鸟们都这么玩的！

首先我们来看看在Spring中为什么要使用异步编程，它能解决什么问题？

为什么要用异步框架，它解决什么问题？#

在SpringBoot的日常开发中，一般都是同步调用的。但实际中有很多场景非常适合使用异步来处理，如：注册新用户，送100个积分；或下单成功，发送push消息等等。

就拿注册新用户这个用例来说，为什么要异步处理？

• 第一个原因：容错性、健壮性，如果送积分出现异常，不能因为送积分而导致用户注册失败； 因为用户注册是主要功能，送积分是次要功能，即使送积分异常也要提示用户注册成功，然后后面在针对积分异常做补偿处理。
• 第二个原因：提升性能，例如注册用户花了20毫秒，送积分花费50毫秒，如果用同步的话，总耗时70毫秒，用异步的话，无需等待积分，故耗时20毫秒。

故，异步能解决2个问题，性能和容错性。

SpringBoot如何实现异步调用？#

对于异步方法调用，从Spring3开始提供了@Async注解，我们只需要在方法上标注此注解，此方法即可实现异步调用。

当然，我们还需要一个配置类，通过Enable模块驱动注解@EnableAsync 来开启异步功能。

实现异步调用#

第一步：新建配置类，开启@Async功能支持

使用@EnableAsync来开启异步任务支持，@EnableAsync注解可以直接放在SpringBoot启动类上，也可以单独放在其他配置类上。我们这里选择使用单独的配置类SyncConfiguration。

@Configuration
@EnableAsync
public class AsyncConfiguration {
}

第二步：在方法上标记异步调用

增加一个Component类，用来进行业务处理，同时添加@Async注解，代表该方法为异步处理。

@Component
@Slf4j
public class AsyncTask {

    @SneakyThrows
    @Async
    public void doTask1() {
        long t1 = System.currentTimeMillis();
        Thread.sleep(2000);
        long t2 = System.currentTimeMillis();
        log.info("task1 cost {} ms" , t2-t1);
    }

    @SneakyThrows
    @Async
    public void doTask2() {
        long t1 = System.currentTimeMillis();
        Thread.sleep(3000);
        long t2 = System.currentTimeMillis();
        log.info("task2 cost {} ms" , t2-t1);
    }
}

第三步：在Controller中进行异步方法调用

@RestController
@RequestMapping("/async")
@Slf4j
public class AsyncController {
    @Autowired
    private AsyncTask asyncTask;

    @RequestMapping("/task")
    public void task() throws InterruptedException {
        long t1 = System.currentTimeMillis();
        asyncTask.doTask1();
        asyncTask.doTask2();
        Thread.sleep(1000);
        long t2 = System.currentTimeMillis();
        log.info("main cost {} ms", t2-t1);
    }
}

通过访问http://localhost:8080/async/task查看控制台日志：

2021-11-25 15:48:37 [http-nio-8080-exec-8] INFO com.jianzh5.blog.async.AsyncController:26 - main cost 1009 ms 2021-11-25 15:48:38 [task-1] INFO com.jianzh5.blog.async.AsyncTask:22 - task1 cost 2005 ms 2021-11-25 15:48:39 [task-2] INFO com.jianzh5.blog.async.AsyncTask:31 - task2 cost 3005 ms

通过日志可以看到：主线程不需要等待异步方法执行完成，减少响应时间，提高接口性能。

通过上面三步我们就可以在SpringBoot中欢乐的使用异步方法来提高我们接口性能了，是不是很简单？

因为上面的代码忽略了一个最大的问题，就是给@Async异步框架自定义线程池。

为什么要给@Async自定义线程池？#

使用@Async注解，在默认情况下用的是SimpleAsyncTaskExecutor线程池，该线程池不是真正意义上的线程池。

使用此线程池无法实现线程重用，每次调用都会新建一条线程。若系统中不断的创建线程，最终会导致系统占用内存过高，引发OutOfMemoryError错误，关键代码如下：

public void execute(Runnable task, long startTimeout) {
  Assert.notNull(task, "Runnable must not be null");
  Runnable taskToUse = this.taskDecorator != null ? this.taskDecorator.decorate(task) : task;
  //判断是否开启限流，默认为否
  if (this.isThrottleActive() && startTimeout > 0L) {
    //执行前置操作，进行限流
    this.concurrencyThrottle.beforeAccess();
    this.doExecute(new SimpleAsyncTaskExecutor.ConcurrencyThrottlingRunnable(taskToUse));
  } else {
    //未限流的情况，执行线程任务
    this.doExecute(taskToUse);
  }

}

protected void doExecute(Runnable task) {
  //不断创建线程
  Thread thread = this.threadFactory != null ? this.threadFactory.newThread(task) : this.createThread(task);
  thread.start();
}

//创建线程
public Thread createThread(Runnable runnable) {
  //指定线程名，task-1，task-2...
  Thread thread = new Thread(this.getThreadGroup(), runnable, this.nextThreadName());
  thread.setPriority(this.getThreadPriority());
  thread.setDaemon(this.isDaemon());
  return thread;
}

我们也可以直接通过上面的控制台日志观察，每次打印的线程名都是[task-1]、[task-2]、[task-3]、[task-4].....递增的。

正因如此，所以我们在使用Spring中的@Async异步框架时一定要自定义线程池，替代默认的SimpleAsyncTaskExecutor。

Spring提供了多种线程池：

• SimpleAsyncTaskExecutor：不是真的线程池，这个类不重用线程，每次调用都会创建一个新的线程。

• SyncTaskExecutor：这个类没有实现异步调用，只是一个同步操作。只适用于不需要多线程的地

• ConcurrentTaskExecutor：Executor的适配类，不推荐使用。如果ThreadPoolTaskExecutor不满足要求时，才用考虑使用这个类

• ThreadPoolTaskScheduler：可以使用cron表达式

• ThreadPoolTaskExecutor ：最常使用，推荐。 其实质是对java.util.concurrent.ThreadPoolExecutor的包装

为@Async实现一个自定义线程池#

@Configuration
@EnableAsync
public class SyncConfiguration {
    @Bean(name = "asyncPoolTaskExecutor")
    public ThreadPoolTaskExecutor executor() {
        ThreadPoolTaskExecutor taskExecutor = new ThreadPoolTaskExecutor();
        //核心线程数
        taskExecutor.setCorePoolSize(10);
        //线程池维护线程的最大数量,只有在缓冲队列满了之后才会申请超过核心线程数的线程
        taskExecutor.setMaxPoolSize(100);
        //缓存队列
        taskExecutor.setQueueCapacity(50);
        //许的空闲时间,当超过了核心线程出之外的线程在空闲时间到达之后会被销毁
        taskExecutor.setKeepAliveSeconds(200);
        //异步方法内部线程名称
        taskExecutor.setThreadNamePrefix("async-");
        /**
         * 当线程池的任务缓存队列已满并且线程池中的线程数目达到maximumPoolSize，如果还有任务到来就会采取任务拒绝策略
         * 通常有以下四种策略：
         * ThreadPoolExecutor.AbortPolicy:丢弃任务并抛出RejectedExecutionException异常。
         * ThreadPoolExecutor.DiscardPolicy：也是丢弃任务，但是不抛出异常。
         * ThreadPoolExecutor.DiscardOldestPolicy：丢弃队列最前面的任务，然后重新尝试执行任务（重复此过程）
         * ThreadPoolExecutor.CallerRunsPolicy：重试添加当前的任务，自动重复调用 execute() 方法，直到成功
         */
        taskExecutor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        taskExecutor.initialize();
        return taskExecutor;
    }
}

自定义线程池以后我们就可以大胆的使用@Async提供的异步处理能力了。

多个线程池处理#

在现实的互联网项目开发中，针对高并发的请求，一般的做法是高并发接口单独线程池隔离处理。

假设现在2个高并发接口： 一个是修改用户信息接口，刷新用户redis缓存； 一个是下订单接口，发送app push信息。往往会根据接口特征定义两个线程池，这时候我们在使用@Async时就需要通过指定线程池名称进行区分。

为@Async指定线程池名字

@SneakyThrows
@Async("asyncPoolTaskExecutor")
public void doTask1() {
  long t1 = System.currentTimeMillis();
  Thread.sleep(2000);
  long t2 = System.currentTimeMillis();
  log.info("task1 cost {} ms" , t2-t1);
}

当系统存在多个线程池时，我们也可以配置一个默认线程池，对于非默认的异步任务再通过@Async("otherTaskExecutor")来指定线程池名称。

配置默认线程池

可以修改配置类让其实现AsyncConfigurer，并重写getAsyncExecutor()方法，指定默认线程池：

java

@Configuration
@EnableAsync
@Slf4j
public class AsyncConfiguration implements AsyncConfigurer {

    @Bean(name = "asyncPoolTaskExecutor")
    public ThreadPoolTaskExecutor executor() {
        ThreadPoolTaskExecutor taskExecutor = new ThreadPoolTaskExecutor();
        //核心线程数
        taskExecutor.setCorePoolSize(2);
        //线程池维护线程的最大数量,只有在缓冲队列满了之后才会申请超过核心线程数的线程
        taskExecutor.setMaxPoolSize(10);
        //缓存队列
        taskExecutor.setQueueCapacity(50);
        //许的空闲时间,当超过了核心线程出之外的线程在空闲时间到达之后会被销毁
        taskExecutor.setKeepAliveSeconds(200);
        //异步方法内部线程名称
        taskExecutor.setThreadNamePrefix("async-");
        /**
         * 当线程池的任务缓存队列已满并且线程池中的线程数目达到maximumPoolSize，如果还有任务到来就会采取任务拒绝策略
         * 通常有以下四种策略：
         * ThreadPoolExecutor.AbortPolicy:丢弃任务并抛出RejectedExecutionException异常。
         * ThreadPoolExecutor.DiscardPolicy：也是丢弃任务，但是不抛出异常。
         * ThreadPoolExecutor.DiscardOldestPolicy：丢弃队列最前面的任务，然后重新尝试执行任务（重复此过程）
         * ThreadPoolExecutor.CallerRunsPolicy：重试添加当前的任务，自动重复调用 execute() 方法，直到成功
         */
        taskExecutor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        taskExecutor.initialize();
        return taskExecutor;
    }

    /**
     * 指定默认线程池
     */
    @Override
    public Executor getAsyncExecutor() {
        return executor();
    }

    @Override
    public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return (ex, method, params) ->
            log.error("线程池执行任务发送未知错误,执行方法：{}",method.getName(),ex);
    }
}

如下，doTask1()方法使用默认使用线程池asyncPoolTaskExecutor，doTask2()使用线程池otherTaskExecutor，非常灵活。

@Async
public void doTask1() {
  long t1 = System.currentTimeMillis();
  Thread.sleep(2000);
  long t2 = System.currentTimeMillis();
  log.info("task1 cost {} ms" , t2-t1);
}

@SneakyThrows
@Async("otherTaskExecutor")
public void doTask2() {
  long t1 = System.currentTimeMillis();
  Thread.sleep(3000);
  long t2 = System.currentTimeMillis();
  log.info("task2 cost {} ms" , t2-t1);
}

小结#

@Async异步方法在日常开发中经常会用到，大家好好掌握，争取早日成为老鸟！！！

Spring Boot - 异步任务#

https://www.jianshu.com/p/20a4e37314fc

前言#

有时候，前端可能提交了一个耗时任务，如果后端接收到请求后，直接执行该耗时任务，那么前端需要等待很久一段时间才能接受到响应。如果该耗时任务是通过浏览器直接进行请求，那么浏览器页面会一直处于转圈等待状态。一个简单的例子如下所示：

@RestController
@RequestMapping("async")
public class AsyncController {

    @GetMapping("/")
    public String index() throws InterruptedException {
        // 模拟耗时操作
        Thread.sleep(TimeUnit.SECONDS.toMillis(5));
        return "consuming time behavior done!";
    }
}

当我们在浏览器请求localhost:8080/async/页面时，可以看到浏览器一直处于转圈等待状态，这样体验十分不友好。

事实上，当后端要处理一个耗时任务时，通常都会将耗时任务提交到一个异步任务中进行执行，此时前端提交耗时任务后，就可直接返回，进行其他操作。

在 Java 中，开启异步任务最常用的方式就是开辟线程执行异步任务，如下所示：

@RestController
@RequestMapping("async")
public class AsyncController {

    @GetMapping("/")
    public String index() {
        new Thread(new Runnable() {
            @Override
            public void run() {
                try {
                    // 模拟耗时操作
                    Thread.sleep(TimeUnit.SECONDS.toMillis(5));
                } catch (InterruptedException e) {
                    e.printStackTrace();
                }
            }
        }).start();
        return "consuming time behavior processing!";
    }
}

这时浏览器请求localhost:8080/async/，就可以很快得到响应，并且耗时任务会在后台得到执行。

一般来说，前端不会关注耗时任务结果，因此前端只需负责提交该任务给到后端即可。但是如果前端需要获取耗时任务结果，则可通过Future等方式将结果返回，详细内容请参考后文。

事实上，在 Spring Boot 中，我们不需要手动创建线程异步执行耗时任务，因为 Spring 框架已提供了相关异步任务执行解决方案，本文主要介绍下在 Spring Boot 中执行异步任务的相关内容。

执行异步任务#

Spring 3.0 时提供了一个@Async注解，该注解用于标记要进行异步执行的方法，当在其他线程调用被@Async注解的方法时，就会开启一个线程执行该方法。

注：@Async注解通常用在方法上，但是也可以用作类型上，当类被@Async注解时，表示该类中所有的方法都是异步执行的。

在 Spring Boot 中，如果要执行一个异步任务，只需进行如下两步操作：

使用注解@EnableAsync开启异步任务支持，如下所示：

@SpringBootApplication
@ComponentScan("com.yn.async")
@EnableAsync // 开启异步调用
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@EnableAsync注解可以让 Spring 开启异步方法执行，它会让 Spring 扫描被其注解的包及其子包下被@Async注解的类或方法，所以这里我们在根包下配置@EnableAsync。

使用@Async注解标记要进行异步执行的方法，如下所示：

@Service // 假设当前类是一个 Service
@Slf4j
public class AsyncTaskService {

    @Async
    public void asyncTaskWithoutReturnType() throws InterruptedException {
        log.info("asyncTaskWithoutReturnType: AsyncTaskService Thread = {}",Thread.currentThread().getName());
        // 模拟耗时任务
        Thread.sleep(TimeUnit.SECONDS.toMillis(5));
    }

    @Async
    public Future<String> asyncTaskWithReturnType() throws InterruptedException {
        log.info("asyncTaskWithReturnType: AsyncTaskService Thread = {}",Thread.currentThread().getName());
        // 模拟耗时任务
        Thread.sleep(TimeUnit.SECONDS.toMillis(5));
        return new AsyncResult<>("async tasks done!");
    }
}

上述代码使用@Async标记了两个异步执行方法，一个没有返回值的asyncTaskWithoutReturnType，另一个拥有返回值asyncTaskWithReturnType，这里需要注意的一点时，被@Async注解的方法可以接受任意类型参数，但只能返回void或Future类型数据。所以当异步方法返回数据时，需要使用Future包装异步任务结果，上述代码使用AsyncResult包装异步任务结果，AsyncResult间接继承Future，是 Spring 提供的一个可用于追踪异步方法执行结果的包装类。其他常用的Future类型还有 Spring 4.2 提供的ListenableFuture，或者 JDK 8 提供的CompletableFuture，这些类型可提供更丰富的异步任务操作。

如果前端需要获取耗时任务结果，则异步任务方法应当返回一个Future类型数据，此时Controller相关接口需要调用该Future的get()方法获取异步任务结果，get()方法是一个阻塞方法，因此该操作相当于将异步任务转换为同步任务，浏览器同样会面临我们前面所讲的转圈等待过程，但是异步执行还是有他的好处的，因为我们可以控制get()方法的调用时序，因此可以先执行其他一些操作后，最后再调用get()方法。

经过前面两个步骤后，其实就已经完成了异步任务配置。到此就可以调用这些异步任务方法，如下所示：

@RestController
@RequestMapping("async")
@Slf4j
public class AsyncController {

    @Autowired // 注入异步任务类
    private AsyncTaskService asyncTaskService;

    @GetMapping("/asyncTaskWithoutReturnType")
    public void asyncTaskWithoutReturnType() throws InterruptedException {
        log.info("asyncTaskWithoutReturnType: Controller Thread = {}",Thread.currentThread().getName());
        this.asyncTaskService.asyncTaskWithoutReturnType();
    }

    @GetMapping("/asyncTaskWithReturnType")
    public String asyncTaskWithReturnType() throws Exception {
        log.info("asyncTaskWithReturnType: Controller Thread = {}",Thread.currentThread().getName());
        Future<String> future = this.asyncTaskService.asyncTaskWithReturnType();
        return future.get();
    }
}

请求上述两个接口，如下所示：

$ curl -X GET localhost:8080/async/asyncTaskWithoutReturnType

$ curl -X GET localhost:8080/async/asyncTaskWithReturnType
async tasks done!

查看日志，如下图所示：

可以看到，异步任务方法运行在于Controller不同的线程上。

异步任务相关限制#

被@Async注解的异步任务方法存在相关限制：

• 被@Async注解的方法必须是public的，这样方法才可以被代理。

• 不能在同一个类中调用@Async方法，因为同一个类中调用会绕过方法代理，调用的是实际的方法。

• 被@Async注解的方法不能是static。

• _{`@Async`不能用于被`@Configuration`注解的类方法上。}
  注：官方文档写的是不能在@Configuration类中使用，但本人实际测试发现，无论是将@Async注解到@Configuration类上，还是将@Async注解到方法上，都是可以异步执行方法的。

• @Async注解不能与 Bean 对象的生命周期回调函数（比如@PostConstruct）一起注解到同一个方法中。解决方法可参考：Spring - The @Async annotation

• 异步类必须注入到 Spring IOC 容器中（也即异步类必须被@Component/@Service等进行注解）。

• 其他类中使用异步类对象必须通过@Autowired等方式进行注入，不能手动new对象。

自定义 Executor#

默认情况下，Spring 会自动搜索相关线程池定义：要么是一个唯一TaskExecutor Bean 实例，要么是一个名称为taskExecutor的Executor Bean 实例。如果这两个 Bean 实例都不存在，就会使用SimpleAsyncTaskExecutor来异步执行被@Async注解的方法。

综上，可以知道，默认情况下，Spring 使用的 Executor 是SimpleAsyncTaskExecutor，SimpleAsyncTaskExecutor每次调用都会创建一个新的线程，不会重用之前的线程。很多时候，这种实现方式不符合我们的业务场景，因此通常我们都会自定义一个 Executor 来替换SimpleAsyncTaskExecutor。

对于自定义 Executor（自定义线程池），可以分为如下两个层级：

• 方法层级：即为单独一个或多个方法指定运行线程池，其他未指定的异步方法运行在默认线程池。如下所示：

  @SpringBootApplication
  @ComponentScan("com.yn.async")
  @EnableAsync
  public class Application {
      // ...
      @Bean("methodLevelExecutor1")
      public TaskExecutor getAsyncExecutor1() {
          ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
          // 设置核心线程数
          executor.setCorePoolSize(4);
          // 设置最大线程数
          executor.setMaxPoolSize(20);
          // 等待所有任务结束后再关闭线程池
          executor.setWaitForTasksToCompleteOnShutdown(true);
          // 设置线程默认前缀名
          executor.setThreadNamePrefix("Method-Level-Async1-");
          return executor;
      }
  
      @Bean("methodLevelExecutor2")
      public TaskExecutor getAsyncExecutor2() {
          ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
          // 设置核心线程数
          executor.setCorePoolSize(8);
          // 设置最大线程数
          executor.setMaxPoolSize(20);
          // 等待所有任务结束后再关闭线程池
          executor.setWaitForTasksToCompleteOnShutdown(true);
          // 设置线程默认前缀名
          executor.setThreadNamePrefix("Method-Level-Async2-");
          return executor;
      }
  }
  

  上述特意设置了多个TaskExecutor，因为如果只设置一个TaskExecutor，那么 Spring 就会默认采用该TaskExecutor作为所有@Async的Executor，而设置了多个TaskExecutor，Spring 检测到全局存在多个Executor，就会降级使用默认的SimpleAsyncTaskExecutor，此时我们就可以为@Async方法配置执行线程池，其他未配置的@Async就会默认运行在SimpleAsyncTaskExecutor中，这就是方法层级的自定义 Executor。如下代码所示：

  @RestController
  @RequestMapping("async")
  @Slf4j
  public class AsyncController {
  
      @Autowired // 注入异步任务类
      private AsyncTaskService asyncTaskService;
  
      @GetMapping("/asyncTaskWithoutReturnType")
      public void asyncTaskWithoutReturnType() throws InterruptedException {
          log.info("asyncTaskWithoutReturnType: Controller Thread = {}",Thread.currentThread().getName());
          this.asyncTaskService.asyncTaskWithoutReturnType();
      }
  
      @GetMapping("/asyncTaskWithReturnType")
      public String asyncTaskWithReturnType() throws Exception {
          log.info("asyncTaskWithReturnType: Controller Thread = {}",Thread.currentThread().getName());
          Future<String> future = this.asyncTaskService.asyncTaskWithReturnType();
          return future.get();
      }
  }
  

  请求上述接口，如下所示：

  $ curl -X GET localhost:8080/async/asyncTaskWithoutReturnType
  
  $ curl -X GET localhost:8080/async/asyncTaskWithReturnType
  async tasks done!
  

  请求日志如下所示：

  2020-09-25 00:55:31,953 INFO  [http-nio-8080-exec-1] com.yn.async.AsyncController: asyncTaskWithoutReturnType: Controller Thread = http-nio-8080-exec-1
  2020-09-25 00:55:31,984 INFO  [Method-Level-Async1-1] com.yn.async.AsyncTaskService: asyncTaskWithoutReturnType: AsyncTaskService Thread = Method-Level-Async1-1
  2020-09-25 00:55:45,592 INFO  [http-nio-8080-exec-2] com.yn.async.AsyncController: asyncTaskWithReturnType: Controller Thread = http-nio-8080-exec-2
  2020-09-25 00:55:45,594 INFO  [http-nio-8080-exec-2] org.springframework.aop.interceptor.AsyncExecutionAspectSupport: More than one TaskExecutor bean found within the context, and none is named 'taskExecutor'. Mark one of them as primary or name it 'taskExecutor' (possibly as an alias) in order to use it for async processing: [methodLevelExecutor1, methodLevelExecutor2]
  2020-09-25 00:55:45,595 INFO  [SimpleAsyncTaskExecutor-1] com.yn.async.AsyncTaskService: asyncTaskWithReturnType: AsyncTaskService Thread = SimpleAsyncTaskExecutor-1
  

  结果跟我们上述的分析一致。

• 应用层级：即全局生效的 Executor。依据 Spring 默认搜索机制，其实就是配置一个全局唯一的TaskExecutor实例或者一个名称为taskExecutor的Executor实例即可，如下所示：

  @SpringBootApplication
  @ComponentScan("com.yn.async")
  @EnableAsync
  public class Application {
      // ...
      @Bean("taskExecutor")
      public Executor getAsyncExecutor() {
          ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
          // 设置核心线程数
          int cores = Runtime.getRuntime().availableProcessors();
          executor.setCorePoolSize(cores);
          // 设置最大线程数
          executor.setMaxPoolSize(20);
          // 等待所有任务结束后再关闭线程池
          executor.setWaitForTasksToCompleteOnShutdown(true);
          // 设置线程默认前缀名
          executor.setThreadNamePrefix("Application-Level-Async-");
          return executor;
      }
  }
  

  上述代码定义了一个名称为taskExecutor的Executor，此时@Async方法默认就会运行在该Executor中。

  其实 Spring 还提供了另一个功能更加强大的接口AsyncConfigurer，该接口主要是用于自定义一个Executor配置类，提供了应用层级Executor接口，以及对于@Async方法异常捕获功能。如果 Spring 检测到该接口实例，会优先采用该接口自定义的Executor。如下所示：

  @Configuration
  @EnableAsync
  public class AsyncConfigure implements AsyncConfigurer {
      @Override
      public Executor getAsyncExecutor() {
          ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
          // 设置核心线程数
          int cores = Runtime.getRuntime().availableProcessors();
          executor.setCorePoolSize(cores);
          // 设置最大线程数
          executor.setMaxPoolSize(20);
          // 等待所有任务结束后再关闭线程池
          executor.setWaitForTasksToCompleteOnShutdown(true);
          // 设置线程默认前缀名
          executor.setThreadNamePrefix("AsyncConfigure-");
          // 注意，此时需要调用 initialize
          executor.initialize();
          return executor;
      }
  }
  

  注：使用自定义实现AsyncConfigurer接口的配置类的另一个好处就是无论@EnableAsync的包层级多深，默认都会对整个项目扫描@Async方法，这样我们就无需将@EnableAsync注解到根包类中。

异常处理#

前文介绍过，对于被@Async注解的异步方法，只能返回void或者Future类型。对于返回Future类型数据，如果异步任务方法抛出异常，则很容易进行处理，因为Future.get()会重新抛出该异常，我们只需对其进行捕获即可。但是对于返回void的异步任务方法，异常不会传播到被调用者线程，因此我们需要自定义一个额外的异步任务异常处理器，捕获异步任务方法抛出的异常。

自定义异步任务异常处理器的步骤如下所示：

1. 首先自定义一个异常处理器类实现接口AsyncUncaughtExceptionHandler，如下所示：

   public class CustomAsyncExceptionHandler implements AsyncUncaughtExceptionHandler {
       @Override
       public void handleUncaughtException(Throwable throwable, Method method, Object... objects) {
           System.out.println("Exception message - " + throwable.getMessage());
           System.out.println("Method name - " + method.getName());
           for (Object param : objects) {
               System.out.println("Parameter value - " + param);
           }
       }
   }
   

2. 然后，创建一个自定义Executor异步配置类，将我们的自定义异常处理器设置到其接口上。如下所示：

   @Configuration
   @EnableAsync
   public class AsyncConfigure implements AsyncConfigurer {
       // ...
   
       @Override
       public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
           return new CustomAsyncExceptionHandler();
       }
   }
   

   此时异步方法如果抛出异常，就可以被我们的自定义异步异常处理器捕获得到。

参考#

• Spring - The @Async annotation
• How To Do @Async in Spring