外观
18 - 结构化并发与任务生命周期
版本说明:本文以 JDK 21–25 的预览 API 思路为主。JDK 25 中 Structured Concurrency 仍为预览特性,API 可能继续变化;引入前必须核对目标 JDK 的 JEP 和 API 文档。
摘要
一个请求并发查询用户和订单,其中一个已失败,另一个为什么还在运行?因为两个任务分别提交后,请求退出并不会自动管理它们的结束过程。结构化并发(Structured Concurrency)把同一次操作中的子任务放进明确的作用域,集中安排等待、失败处理和取消,让调用方能沿着父子关系理解任务的生命周期。
本文先解释这一模型,再介绍概念性代码、预览 API 的版本边界和业务策略。
1. 非结构化任务的问题
Future 是调用方等待结果、查询状态和请求取消的句柄。拿到两个 Future,并不意味着这两个任务已经具有共同的生命周期。
下面是局部业务片段,假定 executor 是执行器,id 是查询参数,loadUser、loadOrders 和 View 等是业务方法或类型;导入、外围方法和异常处理未展示:
java
Future<User> user = executor.submit(() -> loadUser(id));
Future<List<Order>> orders = executor.submit(() -> loadOrders(id));
return new View(user.get(), orders.get());两个查询先后提交,可以并发执行;结果却按 user.get()、orders.get() 的顺序读取。如果 user.get() 抛出异常,当前方法就无法继续取得订单结果,而这段代码没有取消订单任务。反过来,如果订单查询先失败,调用方也可能仍在等待用户查询,尚未读取订单的失败结果。
因此,提交任务之后,还需要明确以下责任:
- 一个查询失败时,是否取消另一个查询;
- 当前请求超时时,谁负责向两个任务传递取消请求;
- 方法退出时,谁负责等待子任务结束并清理资源;
- 日志和线程 Dump(线程诊断快照)如何关联同一请求的任务。
手工组合 Future 可以实现这些安排。但成功、异常、超时和中断会形成多条退出路径,每条路径都要处理仍在运行的任务,容易遗漏取消或清理。
2. 结构化的核心约束
这里把发起查询的请求逻辑称为父任务,把用户查询和订单查询称为子任务。作用域是管理这组子任务的边界:父任务在其中启动子任务、等待结果,并在离开时完成结束处理。它让并发任务具有类似方法调用栈的父子关系,而不是只留下几个彼此独立的结果句柄。
图表将在阅读到此处时加载…
图中的“汇合”指父任务按照选定策略等待这组任务,例如等待全部成功,或在某个任务失败后结束正常等待并请求取消其余任务。
结构化模型要约束的是:父任务不能把仍需管理的子任务遗留到作用域之外。理解这一约束时,必须区分“任务正常完成”“已经请求取消”和“执行任务的线程实际退出”。进入取消处理只是结束过程的一步,不能据此断言底层工作已经停止;关闭是否及时完成,还取决于子任务能否响应取消。具体等待和关闭语义必须以目标 JDK 的 API 契约为准。
3. 概念性示例
下面保留 JDK 25 思路的局部片段。StructuredTaskScope 是管理子任务的作用域;Joiner 表达这组任务如何汇合、如何处理结果或失败。这里选择的策略是等待全部成功,否则抛出失败。业务类型、查询方法、导入和外围异常处理均未展示:
java
// 预览 API:类名和调用方式必须以目标 JDK 为准
try (var scope = StructuredTaskScope.open(
StructuredTaskScope.Joiner.<Object>awaitAllSuccessfulOrThrow())) {
var user = scope.fork(() -> loadUser(id));
var orders = scope.fork(() -> loadOrders(id));
scope.join();
return new View((User) user.get(), (List<Order>) orders.get());
}按这个片段表达的思路,open 创建作用域,两个 fork 启动子任务,join 按策略等待,之后再读取查询结果并组装 View。try 后的资源声明把作用域关闭放在统一的退出路径中,正常返回或异常退出都要经过这一步。关闭与取消的实际行为仍需核对对应版本。
该代码只用于表达结构化思路,不是可直接运行的完整示例,也不是跨 JDK 版本的稳定 API 模板。片段使用 Object 汇合不同结果类型,再进行类型转换;实际项目还要检查泛型和结果获取方式是否符合目标版本。在不同预览版本中,作用域的创建、Joiner 和子任务结果 API 可能变化。
版本演进
理解模型后,再看 API 的版本边界。预览特性用于在正式定稿前提供试用和反馈机会,不能按稳定 API 的兼容性来使用。
| JDK | JEP | 状态与重要变化 |
|---|---|---|
| 21 | JEP 453 | 第一次预览 |
| 22 | JEP 462 | 第二次预览 |
| 23 | JEP 480 | 第三次预览 |
| 24 | JEP 499 | 第四次预览 |
| 25 | JEP 505 | 第五次预览,引入新的作用域与 Joiner API 形态 |
JEP 是 JDK Enhancement Proposal,即 JDK 增强提案;它说明特性的目标和设计。Javadoc 则用于核对具体 API 的参数、返回值、异常与使用约束。
不能只把 --release 数字从 21 改成 25:构造作用域、失败策略和取得子任务结果的 API 都可能需要调整。本文示例采用 JDK 25 思路,其他版本必须查阅对应 JEP 与 Javadoc。
预览特性在编译和运行时都要显式启用。下面仅展示已有 Example.java 时的参数形式,不表示本文片段已保存为完整程序或已执行:
bash
javac --enable-preview --release 25 Example.java
java --enable-preview Example库若把预览类型暴露在公开方法签名中,使用方也会受到相应版本和启动参数要求的影响。因此,更适合先在应用内部、受控模块或实验分支采用。
4. 失败策略不是只有一种
同一组任务如何结束,要先由业务决定。用户和订单都不可缺少时,任一查询失败就无法组装完整结果;如果多个任务只是查询同一信息的不同来源,拿到一个成功结果可能就够了。
| 业务语义 | 常见策略 |
|---|---|
| 所有子任务都必须成功 | 任一失败后取消其余任务 |
| 任意一个结果即可 | 首个成功后取消其余任务 |
| 允许部分结果 | 等待到 Deadline,区分成功、失败和未完成 |
“首个成功”不等于“首个完成”:最先完成的任务也可能失败。“允许部分结果”则需要定义缺少哪些结果仍可返回,以及如何向调用方表示失败或未完成。Deadline 是截止时间,用于规定最迟等到何时,下一节讨论它与取消的关系。
结构化并发让这些策略集中在作用域边界表达,业务仍需选择策略,并通过目标版本的 API 实现;上表不是所有预览版本都提供同名内置策略的保证。
5. Deadline 与取消
作用域的时间预算应来自上游 Deadline。否则,请求只剩很少时间,子任务却重新获得一段完整的等待时间,就可能继续占用下游资源。预算传播见 分布式 11 - 超时预算与 Deadline。
Deadline 到期后,需要分别处理停止等待、请求取消和任务退出。即使作用域已请求取消,底层 HTTP、数据库和 Native(本地代码)调用仍需要自身超时与中断支持。如果某次调用一直不返回,子任务就无法及时执行退出和资源清理逻辑,作用域也可能无法及时结束。因此,Deadline 是需要落实到各层的预算,不能当作强制终止所有工作的保证。
取消也不会自动撤销外部副作用,例如已经提交的数据库写入或已经发送的消息。作用域负责组织任务生命周期;外部状态能否回滚、是否需要补偿,仍由业务的事务和一致性策略决定。
6. 与 CompletableFuture 的边界
CompletableFuture 适合组合已有异步 API 和显式任务图,即用依赖关系描述“哪些任务完成后再执行哪些任务”。结构化并发更强调父子任务的词法范围:从代码块的边界就能看出任务由谁创建、在哪里等待和关闭。共同取消与可观测性也围绕这一父子关系组织。
选择时先看已有接口和生命周期需求:需要连接已有异步结果,可以考虑 CompletableFuture;需要把同一次操作拆成一组受共同边界管理的任务,可以评估结构化并发。详见 10 - CompletableFuture 异步编排。
7. 容易踩的坑
除取消、Deadline 和副作用的边界外,引入时还要注意:
- 在需要稳定 API 的公共库中直接绑定预览 API,把迁移要求传递给使用方。
- 同时启动大量子任务,却没有限制数据库连接和下游并发。任务有共同作用域,不代表下游容量足够。
- 编译时启用了 preview,生产启动参数却遗漏
--enable-preview。 - 跨 JDK 复制预览 API 示例,只修类名,没有重新验证失败和关闭语义。
8. 升级验证
下面是每次升级目标 JDK 时的验证建议,不是本文已执行的实验记录:
- 确认编译参数、运行参数和容器镜像使用同一大版本。
- 检查作用域关闭路径:子任务是否正常完成或收到取消请求,并另行观察任务实际退出,不能只凭取消状态判断没有遗留工作。
- 验证任一失败、首个成功和部分结果三种策略是否符合业务预期。
- 在 Deadline 到期后,确认底层连接和许可最终释放。许可指限制并发访问数量的配额,任务退出时需要归还。
- 检查 JFR(Java Flight Recorder,Java 飞行记录器)、日志和线程诊断是否仍能关联父任务与子任务。
应覆盖子任务忽略中断、底层 I/O(输入输出操作)缺少超时等异常路径,观察取消请求与实际退出之间的差距。
9. 总结
结构化并发把同一次操作中的任务组织为可见的父子关系,让等待、失败处理和关闭集中在一个边界内。使用时先确定这组任务的业务结束条件,再把 Deadline、取消响应、资源释放和外部副作用处理落实到各层;采用预览 API 时,还要锁定目标 JDK 并验证迁移行为。
本文仅做文本改写与静态自查,未编译或运行示例,也未独立核验 JEP、Javadoc 或源码。版本表、概念性代码及具体汇合、取消和关闭语义仍需结合目标 JDK 核对。
后续阅读:21 - 并发上下文传播与 ScopedValue讨论父子任务中的只读上下文边界。