Spring @Async 典型用法

典型用法

⚠️ 注意:@Async 方法不能是 private,也不能在同一个类中直接调用,否则代理失效。

基础用法:异步发送邮件

在配置类上添加 @EnableAsync 来启用异步功能,方法被 @Async 标记后,Spring 会自动将其放入线程池中异步执行。

java 复制代码
// 启用异步支持(必须配置)
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableAsync;

@Configuration
@EnableAsync
public class AsyncConfig {
}

--------------------------------------------------------------
// 异步发送邮件
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;

@Service
public class EmailService {

    @Async
    public void sendEmail(String to, String content) {
        // 模拟耗时操作
        System.out.println("正在异步发送邮件给:" + to);
        try {
            Thread.sleep(1000); // 模拟发送耗时
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
}

自定义线程池(推荐做法)

默认使用的是 Spring 的简单线程池,建议自定义以提高性能和可控性。

java 复制代码
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.Executor;

@Configuration
public class CustomAsyncConfig {

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

然后在服务中指定使用该线程池:

java 复制代码
@Async("emailTaskExecutor")
public void sendEmail(String to, String content) {
    // 发送逻辑
}

异常处理(推荐封装)

异步方法中的异常不会直接抛出到主线程,需手动捕获或使用 try-catch 处理,也可以结合 @ControllerAdvice 或日志框架统一处理。

java 复制代码
@Async
public void doSomething() {
    try {
        // 执行任务
    } catch (Exception e) {
        // 记录日志或上报监控
        System.err.println("异步任务发生异常:" + e.getMessage());
    }
}

返回值类型支持

java 复制代码
// void 类型(无返回值)
@Async
public void logAccess(String user) {
    // 记录用户访问日志
}

//  Future / CompletableFuture(有返回值)
@Async
public Future<String> fetchData() {
    String result = "数据加载完成";
    return new AsyncResult<>(result);
}
相关推荐
阿华的代码王国12 分钟前
【Android】搭配安卓环境及设备连接
android·java
YuTaoShao23 分钟前
【LeetCode 热题 100】141. 环形链表——快慢指针
java·算法·leetcode·链表
铲子Zzz1 小时前
Java使用接口AES进行加密+微信小程序接收解密
java·开发语言·微信小程序
霖檬ing1 小时前
K8s——配置管理(1)
java·贪心算法·kubernetes
float_六七1 小时前
SQL六大核心类别全解析
数据库·sql·oracle
Vic101012 小时前
Java 开发笔记:多线程查询逻辑的抽象与优化
java·服务器·笔记
Biaobiaone2 小时前
Java中的生产消费模型解析
java·开发语言
特立独行的猫a2 小时前
11款常用C++在线编译与运行平台推荐与对比
java·开发语言·c++
louisgeek2 小时前
Java 位运算
java
Code季风3 小时前
将 gRPC 服务注册到 Consul:从配置到服务发现的完整实践(上)
数据库·微服务·go·json·服务发现·consul