Java ProcessHandle 怎么判断子进程已退出：退出码、句柄状态与回收边界

线上服务偶尔需要拉起一个短命 Java 工具：执行结束后记录结果，失败时给出明确告警。只调用 isAlive() 只能知道“现在还活着”，不能直接回答它何时结束、退出码是多少，也不能替代等待逻辑。Java 9 引入的 ProcessHandle 把这几件事拆成了清楚的 API。

先把子进程的三个状态问题分开

拿一个运行300毫秒后返回指定状态码的子进程场景举例，进程调用方一般需要处理三类逻辑：启动后判断进程是否还在运行，等待它执行结束，最后根据返回的退出码判定任务成功还是失败。这三类逻辑分别对应不同的时间节点和判断逻辑。

• isAlive()：瞬时查询，返回当前是否仍存活。
• onExit()：返回一个 CompletableFuture，在目标结束后完成。
• exitValue()：只适合已经结束的进程；进程还活着时调用会抛出 IllegalThreadStateException。

第一处容易出错的地方是把“查询结果”当成“完成通知”。isAlive() 返回 false 时可以继续取退出码，但返回 true 时应该等待，而不是循环空转。

最小实现：等待完成后再读取退出码

下面的示例代码让子进程休眠一小段时间后返回7作为退出码，整个演示逻辑不引入任何第三方依赖，完全基于JDK自带的API实现，方便你直接本地验证效果：

import java.util.concurrent.TimeUnit;

public class ProcessExitCheck {
    public static void main(String[] args) throws Exception {
        Process process = new ProcessBuilder(
                "java", "-version")
                .inheritIO()
                .start();

        ProcessHandle handle = process.toHandle();
        System.out.println("started=" + handle.pid());
        System.out.println("alive-now=" + handle.isAlive());

        ProcessHandle ended = handle.onExit().get(5, TimeUnit.SECONDS);
        int code = process.exitValue();
        System.out.println("same-handle=" + (ended.pid() == handle.pid()));
        System.out.println("exit-code=" + code);
    }
}

这里的关键不是 get() 本身，而是它发生在 onExit() 返回的完成阶段之后。若业务线程不能阻塞，可以把后半段放进 thenApply 或 thenAccept，但仍要在回调中读取退出码。

交互状态怎么接到业务结果

如果需要把子进程的运行结果映射成“成功、失败、超时”三类业务状态，返回给前端页面或者上层任务调度逻辑，你可以先提前定义好有限状态转换规则：

ProcessHandle handle = process.toHandle();

handle.onExit()
        .orTimeout(5, TimeUnit.SECONDS)
        .thenAccept(ended -> {
            int code = process.exitValue();
            if (code == 0) {
                System.out.println("task=success");
            } else {
                System.out.println("task=failed, code=" + code);
            }
        })
        .exceptionally(error -> {
            System.out.println("task=timeout-or-wait-failed");
            return null;
        });

orTimeout 只让等待结果超时，不会自动终止外部进程。超时分支需要按业务决定是否调用 process.destroy()，必要时再等待一小段时间确认它确实结束。否则任务记录可能已经显示超时，后台进程却仍然占着文件或端口。

三个常见误区会让状态记录失真

只轮询 isAlive()

每隔几十毫秒轮询一次既浪费线程，又容易在最后一次查询和退出码读取之间留下竞态。一次性的 onExit() 更适合等待完成；轮询只留给需要周期性展示进度的场景。

把超时当成进程已经停止

等待 future 超时只说明调用方没有在期限内得到完成信号。记录超时后，应显式销毁进程并再次检查 isAlive()。如果子进程创建了孙进程，单独销毁父进程也不等于整个进程树结束。

从回调里无条件读取 exitValue

正常的 onExit() 回调表示目标进程已经结束，但如果代码把另一个 future、手动取消或异常分支混在一起，就不能假定所有路径都能读取退出码。最好先区分等待成功、等待失败和主动取消，再读取结果。

验收时看日志，不只看一个布尔值

最小验收至少记录 PID、启动时间、等待结果、退出码和最终存活状态。成功任务应满足退出码为 0 且 isAlive() 为 false；非零退出要保留标准错误输出或任务编号；超时则需要记录销毁动作和二次检查结果。

System.out.printf(
        "pid=%d alive=%s code=%d%n",
        handle.pid(), handle.isAlive(), process.exitValue());

如果你只需要“是否结束”，handle.onExit().thenAccept(...) 已经足够；如果需要执行结果，就把退出码和输出一起纳入任务状态。这样页面上的“已完成”才对应一个可复查的事实，而不是一次偶然的状态采样。

相关问题

ProcessHandle 和 Process 是重复的吗？

不是。Process 更接近当前 Java 启动的子进程，提供输入输出、销毁和退出码；ProcessHandle 提供 PID、父子关系、存活状态和异步退出通知。需要进程关系或异步等待时，通常从 process.toHandle() 开始。

读取退出码前是否必须调用 waitFor？

不必须。waitFor() 是阻塞等待，onExit() 是 future 风格等待；二者都可以在确认进程结束后再调用 exitValue()，不要在未结束时直接读取。

超时后 destroy 一次就够吗？

不一定。优先使用温和的销毁操作，执行完再校验一次进程存活状态；如果进程依然没有退出，再结合当前任务的风险等级选择更强制的终止方案，同时把最终的执行结果落盘记录。涉及进程树和子孙进程的场景，要单独设计对应的回收逻辑，不能直接复用普通单进程的处理写法。

把“当前进程是否存活”“进程何时执行结束”“进程以什么状态退出”三个维度分开建模，使用ProcessHandle就不会出现靠随机轮询碰结果的问题。实际业务接入的时候，最先补全的逻辑应该是超时后的二次状态校验，还有可回溯的运行日志记录。