登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

Java StructuredTaskScope.Subtask.state 怎样区分未完成、成功与失败

来源:17golang原创

时间:2026-11-20 11:34:42 137浏览 收藏

在 Java 结构化并发里,判断子任务“成功还是失败”不能只看 get() 是否抛异常。更稳妥的做法是先调用 Subtask.state():SUCCESS 才读取结果,FAILED 才读取异常,UNAVAILABLE 则表示结果或异常暂时不可用,常见于任务尚未完成或 scope 已取消。

记住一条边界:scope owner 在 join() 之后读取已经成功或失败的子任务;取消后的 UNAVAILABLE 不是业务失败,不能直接当成异常处理。

官方文档:https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/StructuredTaskScope.Subtask.html#state()

先把三种状态和可读取内容对齐

state() 返回的是 StructuredTaskScope.Subtask.State。它描述的是子任务当前是否有可供 owner 读取的结果,而不是给业务异常分级。

状态含义后续动作
UNAVAILABLE仍未完成、取消后未产生可用结果,或在取消后创建不要调用 get() 或 exception()
SUCCESS任务正常返回调用 get() 读取结果
FAILED任务以异常或错误结束调用 exception() 读取失败原因
StructuredTaskScope.Subtask.state 三种状态与结果读取关系的静态说明图
图1:Subtask.state() 三种状态与可读取内容的静态说明图,不是截图或运行证据。

在 join 之后读取成功和失败子任务

下面的示例故意安排一个正常返回的任务和一个抛出异常的任务。示例使用 Java 25 的预览版 StructuredTaskScope,编译和运行时要按目标 JDK 开启预览特性。关键点不是把所有调用都包在 try/catch 里,而是先让 scope 完成等待,再按状态选择读取方法。

import java.util.concurrent.StructuredTaskScope;

public class StateDemo {
    public static void main(String[] args) throws Exception {
        // scope 结束时自动关闭,避免遗漏子任务资源回收
        try (var scope = StructuredTaskScope.open()) {
            var success = scope.fork(() -> "ready");
            var failure = scope.fork(() -> {
                // 用异常结束一个子任务,便于观察 FAILED 状态
                throw new IllegalStateException("demo failure");
            });

            // 先等待子任务完成,再由 owner 读取结果或异常
            scope.join();
            printState("success", success);
            printState("failure", failure);
        }
    }

    static void printState(String name, StructuredTaskScope.Subtask task) {
        // state() 决定后续应该调用 get() 还是 exception()
        switch (task.state()) {
            case SUCCESS -> System.out.println(name + ": " + task.get());
            case FAILED -> System.out.println(name + ": " + task.exception());
            case UNAVAILABLE -> System.out.println(name + ": result unavailable");
        }
    }
}

这里的 get() 和 exception() 都只在对应状态分支执行。这样写还有一个好处:失败子任务的异常不会被误当成 scope 自身的异常,后续可以按业务决定记录、降级或终止父任务。

处理取消和读取时机

UNAVAILABLE 是最容易误判的状态。子任务被 fork 后尚未完成时,它还没有可读取的结论;scope 被取消时,未完成任务也可能停留在不可用状态。若任务是在 scope 已取消后 fork 的,甚至不会真正创建执行线程。

因此,排查这类问题时按下面的顺序判断:

  • 先确认调用者是 scope owner;非 owner 线程不能越过结构化并发的访问边界。
  • 确认已经执行 join()。在等待完成前,不要凭一次 state() 结果读取数据。
  • 看到 UNAVAILABLE 时检查取消原因和任务完成时机,不要直接包装成业务异常。
  • 只有 SUCCESS 读取 get(),只有 FAILED 读取 exception()。
StructuredTaskScope join 取消与结果读取边界的结构说明图
图2:join、取消与结果读取边界的结构说明图,不是截图或运行证据。

复查时最容易漏掉的边界

第一,state() 只能说明子任务结果是否可用,不能替代业务状态码;第二,FAILED 表示任务以异常或错误结束,具体原因要从 exception() 取出;第三,try-with-resources 仍然必要,关闭 scope 会处理未完成子任务。若代码需要在取消后保留部分成功结果,也要先判断每个子任务的状态,再决定是否读取。

常见问题

为什么不能直接对每个 Subtask 调用 get?

因为 get() 只适用于 scope owner 在等待完成后读取成功子任务。对未完成、失败或取消后不可用的任务直接读取,无法表达正确的状态边界。

UNAVAILABLE 和 FAILED 有什么区别?

FAILED 已经有明确的异常或错误;UNAVAILABLE 没有可读取的结果或异常,原因可能是尚未完成或被取消。两者的补救动作不同,不能合并处理。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>