当前位置：首页 > news >正文

spring boot的@Async注解有什么坑？

news 2026/5/12 8:09:29

Spring Boot 中 @Async 注解的常见坑（2025-2026 真实生产环境高频问题汇总，按严重程度排序）

排名	坑的名称	严重程度	发生概率	典型表现/后果	解决/规避方案（推荐做法）
1	同一个类内部方法调用不生效	★★★★★	★★★★★	内部调用 @Async 方法，仍然同步执行	1. 把 @Async 方法抽到另一个 Bean 2. 使用 AopContext.currentProxy()（不推荐） 3. 注入自己（Self Injection）最常用
2	没有显式配置 Async 配置类	★★★★½	★★★★	默认单线程池，线程池瞬间打满，所有异步任务排队甚至死锁	必须自定义 ThreadPoolTaskExecutor 或使用 @EnableAsync + 自定义配置类
3	线程池配置不当导致 OOM/任务堆积	★★★★	★★★★½	队列无限增长 → OOM 或响应极慢	合理设置核心/最大线程数 + 有界队列 + 拒绝策略（CallerRunsPolicy 较安全）
4	@Async 方法抛异常调用方收不到	★★★★	★★★★	异常被线程池吞掉，调用方完全感知不到	1. 方法签名返回 CompletableFuture 并 get() 或 join() 2. 实现 AsyncUncaughtExceptionHandler
5	事务失效（@Transactional + @Async）	★★★★	★★★½	异步方法里的事务不生效或不回滚	1. 异步方法不要加 @Transactional（推荐） 2. 或者把事务方法和异步方法分开
6	使用默认的 SimpleAsyncTaskExecutor	★★★½	★★★★	每次调用都 new 线程，无线程复用，性能极差	坚决不要使用默认，必须自定义线程池
7	返回 void 的异步方法异常丢失	★★★½	★★★	void 方法抛异常完全无声无息	实现 AsyncUncaughtExceptionHandler 或改用返回 Future 类型
8	线程上下文丢失（MDC、RequestContext、TenantId 等）	★★★	★★★½	日志 traceId 丢失、租户信息丢失、安全上下文丢失	使用 TaskDecorator 包装 Runnable，复制上下文
9	@Async 用在静态方法/私有方法	★★★	★★½	压根不生效（AOP 无法代理）	只能用在 public 非静态方法上
10	大量 @Async 导致线程饥饿	★★½	★★★	核心业务线程池被异步任务占满，导致主流程卡死	1. 给不同业务类型使用不同线程池 2. 控制异步任务总量

目前生产环境最推荐的安全写法模板（2025-2026 共识）

@Configuration@EnableAsyncpublicclassAsyncConfigimplementsAsyncConfigurer{@OverridepublicExecutorgetAsyncExecutor(){ThreadPoolTaskExecutorexecutor=newThreadPoolTaskExecutor();executor.setCorePoolSize(8);// 根据机器核数调整executor.setMaxPoolSize(32);executor.setQueueCapacity(500);// 有界队列executor.setThreadNamePrefix("Async-");// 拒绝策略：由调用者线程执行（防止任务丢失）executor.setRejectedExecutionHandler(newThreadPoolExecutor.CallerRunsPolicy());executor.setWaitForTasksToCompleteOnShutdown(true);executor.setAwaitTerminationSeconds(60);executor.initialize();returnexecutor;}// 捕获 void 方法的未捕获异常@OverridepublicAsyncUncaughtExceptionHandlergetAsyncUncaughtExceptionHandler(){return(ex,method,params)->{log.error("异步方法异常！method={}, params={}",method.getName(),params,ex);// 可选：发送告警};}}