外观
27 - Spring @Async:异步执行、异常与上下文边界
适用版本:Spring Framework 6.x、Spring Boot 3.x。执行器选择和自动配置属性可能随 Boot 小版本变化,应以目标版本配置元数据和运行时 Bean 为准。
前置阅读:09 - Spring AOP 如何创建代理、10 - 同类调用为什么绕过 AOP和并发 09 - 线程池容量设计。
摘要
给发送通知的方法加上 @Async 后,请求可以先返回,但通知失败如何处理?通知能否看到请求线程的事务和身份信息?理解这些问题,需要先区分“任务已提交”和“任务已完成”。@Async 通过代理把方法调用提交给执行器;当任务跨线程执行时,事务、上下文和异常都需要单独处理。本文先解释调用模型,再讨论执行器、结果观察和任务生命周期。
1. 先判断调用是否真的异步
本文讨论基于代理的 @Async 调用。代理是位于调用方和目标对象之间、负责拦截方法调用的对象;Executor(执行器)负责调度提交的任务,线程池是它的一种实现。异步基础设施需要启用,例如通过 @EnableAsync。
在工作线程执行任务的典型场景中,调用链是:
text
caller → async proxy/interceptor → Executor.submit(...)
→ worker thread → target method代理先向执行器提交任务,调用方无需等目标方法完成便可继续执行;工作线程则在任务获得执行机会后调用目标方法。因此,提交成功不代表业务成功,任务也可能先在队列中等待。是否真正切换线程,还取决于执行器及其拒绝策略。
以下情况不能仅凭注解判断已经异步:
- 同类方法通过
this调用,绕过代理; - 对象不是由 Spring 容器管理;
- 异步基础设施没有启用;
- 调用了原始对象或测试中手工构造的对象;
- 执行器拒绝任务,目标方法根本没有开始。
验证时记录调用线程和执行线程名称,并检查 Bean 是否为代理;不要只用“接口很快返回”作为证据。
1.1 源码调用链
text
AsyncAnnotationBeanPostProcessor
→ AsyncAnnotationAdvisor
→ AnnotationAsyncExecutionInterceptor.invoke(...)
→ determineAsyncExecutor(...)
→ doSubmit(...)
→ Executor.execute/submit(...)AsyncAnnotationBeanPostProcessor 是 Bean 实例后处理器,会在容器创建对象的过程中为匹配 @Async 的 Bean 增加 Advisor。Advisor 将“哪些方法需要拦截”与“拦截时执行什么逻辑”组合起来;异步拦截器再选择执行器并提交包装目标调用的任务。上面的链路用于定位职责,具体方法归属应结合目标版本源码查看。
排障时先确认调用经过代理并匹配异步 Advisor,再检查任务提交和执行器状态。前一步失败意味着没有进入异步提交逻辑,后一步拥塞则意味着任务已经提交却迟迟没有执行。
2. 执行器如何选择
AsyncExecutionInterceptor 会根据注解中的执行器限定名、框架配置和容器解析规则选择目标 Executor。执行器限定名用于指定任务交给哪个执行器,例如 notificationExecutor。Spring Boot 可能提供自动配置执行器;应用声明多个执行器时,显式指定用途可以避免不同业务意外竞争同一组资源。
下面是业务方法片段,需要容器中存在可按 notificationExecutor 解析的执行器,并补齐 Message、SendResult 和 doSend 等业务定义:
java
@Async("notificationExecutor")
public CompletableFuture<SendResult> send(Message message) {
return CompletableFuture.completedFuture(doSend(message));
}这里的 doSend(message) 在目标方法被执行时完成发送,再用 completedFuture 包装结果;它本身没有启动另一个异步任务。跨线程调度来自外部调用经过的 @Async 代理。
生产配置至少要明确:
- 核心与最大线程数;
- 队列容量,而不是只调大最大线程数;
- 拒绝策略及其业务语义;
- 线程命名、指标和日志上下文;
- 应用关闭时等待、取消还是丢弃任务。
当任务到达速度持续超过处理速度,无界队列会不断积累待执行任务,使等待时间和内存占用增长。对于常规 ThreadPoolExecutor,任务能够继续入队时,不会仅因设置了更大的最大线程数就增加线程。调用者运行策略则在满足其执行条件时让提交任务的线程直接执行任务,可能使请求线程承担原本希望移出的工作。容量与拒绝策略需要一起设计。
在纯 Spring Framework 场景中,默认解析会尝试寻找唯一的 TaskExecutor,或名为 taskExecutor 的 Executor;仍未找到时,框架可能退回不复用线程的简单执行器。Spring Boot 通常会按自动配置条件提供应用执行器,但 Bean 名、属性和退让条件依赖 Boot 版本。生产系统不应依赖回退结果。
运行时可以先枚举实际候选。下面是诊断片段,context 为应用的 ApplicationContext(Spring 应用上下文),log 为日志对象;预期日志列出执行器 Bean 的名称和实际类型,但候选列表本身不能证明某个方法最终选择了哪个执行器:
java
context.getBeansOfType(Executor.class)
.forEach((name, executor) ->
log.info("executor name={}, type={}", name, executor.getClass()));若使用 ThreadPoolTaskExecutor,还应暴露其活跃线程、池大小、队列长度和拒绝次数,而不是只记录任务完成耗时。
3. 返回值决定错误是否可观察
| 返回形式 | 调用方如何感知失败 | 主要风险 |
|---|---|---|
CompletableFuture<T> | 完成回调或 join/get | 调用方忘记观察异常 |
Future<T> | get() | 阻塞等待抵消异步收益 |
void | AsyncUncaughtExceptionHandler | 异常不能返回给原调用方 |
Future 是表示稍后完成的结果的句柄;CompletableFuture 还支持完成回调和结果组合。调用方拿到句柄后,仍需观察它最终是成功还是失败。业务任务优先返回可观察的 Future,并明确由谁负责重试、降级或告警。若提交后立即阻塞等待结果,当前调用线程仍会被占用。
要区分提交阶段和执行阶段的失败:执行器拒绝任务时,调用方可能在提交时就收到异常,具体取决于拒绝策略;目标方法开始执行后抛出的异常,则通过返回的 Future 或 AsyncUncaughtExceptionHandler 处理。后者是处理 void 异步方法未捕获异常的回调接口,不能把异常重新抛回已经返回的调用线程。
4. 事务不会自动跨线程
ThreadLocal 将值关联到当前线程,另一个线程访问时不会自然取得同一份值。常见的命令式本地事务机制通过它绑定数据库连接等事务资源,因此调用方在事务中提交异步任务,并不意味着工作线程也处于该事务中:
text
request thread: transaction A → submit → continue/commit
worker thread: independent execution提交任务与数据库提交没有天然的先后保证:工作线程可能在调用方事务提交前就开始读取数据,调用方事务之后也可能回滚。若工作线程中的方法调用经过事务代理,@Transactional 可以按其事务配置开启自己的事务,但这不是调用方事务的延续;组合注解时还需确认代理与拦截顺序。
业务若要求“数据库提交成功后再异步”,应把任务提交安排在成功提交之后。若还要求可靠投递,则需要 Outbox 等持久化协议:Outbox 的基本思路是在业务事务中同时写入待投递事件,再由独立流程投递。仅把任务放入内存执行器,无法保证进程退出后任务仍能完成。
5. 上下文传播必须逐项设计
上下文是一次请求附带的信息,例如租户标识、用户身份和链路标识。MDC(Mapped Diagnostic Context,映射诊断上下文)常用于向日志附加请求字段;Trace 上下文用于关联一次调用链中的记录。这些信息若依赖线程绑定,就不能假设工作线程会自然继承。
TaskDecorator 是任务装饰接口,可在任务执行前后加入上下文处理。传播时可通过它或对应观测组件,在提交阶段捕获所需信息的快照,在执行阶段安装,并在结束后清理或恢复。数据库连接、事务同步器等资源属于事务管理机制,不能把复制它们当作传播事务的方法。
还要防止线程池复用造成污染:
text
capture → install → execute → finally clear/restore线程池会复用工作线程。若只安装上下文而不在 finally 中清理,下一任务就可能读到前一请求的身份或日志字段;若执行前已有上下文,还应按组件语义恢复它,避免直接清空破坏原有状态。
6. 超时、取消与重试
调用方超时只表示不再愿意等待,不代表工作线程或下游请求已经停止。CompletableFuture#cancel 改变结果状态、线程中断发出协作停止信号、底层 I/O 取消终止具体操作,是不同层面的动作,不能假定它们自动相互传播。
如果超时后立即重试,而第一次任务仍在发送通知或写数据库,两次执行就可能重叠。幂等是指同一业务操作重复执行仍不会产生额外业务效果;退避是指重试前等待一段时间,避免持续失败时密集请求下游。任务设计需要:
- 为下游调用设置独立超时;
- 在可中断点正确响应中断;
- 对副作用操作设计幂等;
- 限制重试次数并配置退避;
- 记录排队、执行和端到端耗时。
7. 最小验证方案
- 断言容器返回的是代理对象;
- 用闩锁控制任务开始和完成,避免依赖
sleep; - 记录调用线程、执行线程与事务 active 状态;
- 分别验证成功、业务异常、拒绝、超时和关闭;
- 检查 Future 异常或
AsyncUncaughtExceptionHandler; - 压测时同时观察队列深度、活跃线程和下游连接池。
CountDownLatch 是等待计数降为零的同步工具,常称为闩锁。下面是使用 AssertJ 断言的局部测试骨架,需要补齐导入、服务实现和 Spring 测试配置。service 必须是容器提供的代理;execute 应在进入时调用 entered.countDown(),等待 release 放行后返回当前线程名,专用执行器的线程名前缀设为 async-。
预期断言结果:任务已进入但尚未完成;放行后取得以 async- 开头的线程名。还应记录并比较调用线程和执行线程,避免仅凭名称前缀判断已跨线程:
java
CountDownLatch entered = new CountDownLatch(1);
CountDownLatch release = new CountDownLatch(1);
CompletableFuture<String> future = service.execute(entered, release);
assertThat(entered.await(1, SECONDS)).isTrue();
assertThat(future).isNotDone();
release.countDown();
assertThat(future.get(1, SECONDS)).startsWith("async-");拒绝测试应使用容量极小的专用执行器。例如,一个工作线程加一个队列槽位时,先让第一个任务占住线程,再让第二个任务填满队列,随后提交第三个任务,并按所选拒绝策略断言预期拒绝或降级结果。测试中的等待应有超时,释放闩锁和关闭执行器的清理操作应覆盖断言失败路径,避免测试进程挂起。
Framework 与 Boot 边界
- Framework 定义
@Async、后处理器、拦截器和执行器解析契约; - Boot 在条件满足时提供执行器 Bean、配置属性和指标集成;
spring.task.execution.*等属性是否控制当前@Async执行器,取决于自动配置是否仍然生效以及应用是否自定义了AsyncConfigurer或执行器 Bean;- 虚拟线程相关配置依赖 JDK 与 Boot 版本,不能从 Framework 6.x 这一范围直接推断。
8. 总结
理解 @Async,先确认调用经过代理,再区分任务提交、目标方法执行和结果完成。
跨线程只是调度方式的变化,不会自动提供下游容量或可靠投递。执行器决定任务何时运行及过载时如何处理,返回值决定失败由谁观察,事务与上下文则需要按线程边界单独设计。超时、重试和关闭也必须考虑仍在执行的任务及其业务副作用。
阅读导航
- 代理与自调用:10 - 同类调用与 AOP 失效
- 多个声明式能力的顺序:24 - Spring 切面顺序与组合语义
- 线程池容量:并发 09 - ThreadPoolExecutor 参数与容量设计
- 上下文传播:并发 21 - 并发上下文传播与 ScopedValue
- 任务泄漏和关闭:并发 27 - 并发任务泄漏与进程无法退出
- 可靠事件投递:分布式 29 - Outbox 与 CDC