Java 注解篇：@Async-CSDN博客

本文链接：https://blog.csdn.net/weixin_45277068/article/details/147891713

前言：

在现代 Java 应用程序开发中，异步处理变得越来越重要。尤其是在微服务架构和高并发系统中，异步能力可以显著提升系统的响应性能。Spring Framework 提供了 @Async 注解，使得我们可以轻松实现方法的异步调用。

本文将从基本使用、配置方式到底层实现原理，为大家全面解析 @Async 注解的机制与最佳实践。

一、什么是 @Async？

@Async 是 Spring Framework 提供的用于异步方法执行的注解。它可以将一个普通的方法转变为异步执行的方法。被该注解标记的方法将不会在调用者线程中执行，而是由另一个线程执行，从而不会阻塞主线程。

二、基本使用

1. 引入依赖

如果使用的是 Spring Boot，通常已经自动包含了 spring-context 包，无需额外依赖。如果是普通 Spring 项目，则需要：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
</dependency>

2. 开启异步支持

在配置类上添加 @EnableAsync 注解：

@Configuration
@EnableAsync
public class AsyncConfig {
}

3. 编写异步方法

@Service
public class AsyncService {

    @Async
    public void asyncTask() {
        System.out.println("异步任务开始，线程名：" + Thread.currentThread().getName());
        try {
            Thread.sleep(3000);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
        System.out.println("异步任务结束");
    }
}

调用该方法：

@RestController
public class TestController {

    @Autowired
    private AsyncService asyncService;

    @GetMapping("/test")
    public String test() {
        asyncService.asyncTask();
        return "请求已返回";
    }
}

控制台输出中可以看到，asyncTask() 方法在另一个线程中执行。

三、返回值支持

异步方法不仅可以返回 void，也可以返回 Future<T>、CompletableFuture<T> 等异步结果类型：

@Async
public CompletableFuture<String> asyncTaskWithResult() {
    return CompletableFuture.completedFuture("任务完成");
}

四、自定义线程池

默认情况下，Spring 使用 SimpleAsyncTaskExecutor，它不是真正的线程池，不会重用线程。我们可以自定义线程池以提升性能和可控性：

@Configuration
@EnableAsync
public class AsyncConfig {

    @Bean("taskExecutor")
    public Executor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(5);
        executor.setMaxPoolSize(10);
        executor.setQueueCapacity(100);
        executor.setThreadNamePrefix("AsyncExecutor-");
        executor.initialize();
        return executor;
    }
}

指定使用的线程池：

@Async("taskExecutor")
public void customThreadPoolTask() {
    // 执行逻辑
}

五、异常处理机制

异步方法中抛出的异常不会像同步方法一样直接传递给调用者。可以通过 AsyncUncaughtExceptionHandler 来统一处理异常：

@Configuration
@EnableAsync
public class AsyncConfig implements AsyncConfigurer {

    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(5);
        executor.setMaxPoolSize(10);
        executor.setQueueCapacity(100);
        executor.setThreadNamePrefix("AsyncExecutor-");
        executor.initialize();
        return executor;
    }

    @Override
    public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return (throwable, method, objects) -> {
            System.err.println("异步方法发生异常：" + throwable.getMessage());
        };
    }
}