Java通过子进程启动外部jar执行卡住，命令行直接运行正常

核心根因 #

Java子进程管道缓冲区阻塞死锁，是JDK Process API长期存在的经典问题，和你观测到的新旧版本差异、命令行运行正常的现象完全匹配。
Java通过ProcessBuilder启动子进程时，父子进程间依靠系统固定大小的内存管道传输stdout、stderr输出，macOS环境下管道缓冲区默认仅约64KB。如果父进程不及时读取管道内的输出内容，一旦缓冲区被写满，子进程执行到往管道写输出的逻辑时，会直接陷入阻塞无法继续执行。

现象匹配逻辑 #

所有观测到的异常表现，都可以被这个根因完全解释：

• 直接在终端运行引擎正常：终端程序本身会持续消费stdout、stderr的输出，管道永远不会达到缓冲区上限，不存在阻塞触发条件。
• 旧版本引擎无问题、新版本引擎在文件分类环节挂起：旧版本在文件分类环节几乎没有日志输出，长运行时间都写不满管道缓冲区；新版本新增了进度条展示，会在分类环节高频输出进度刷新字符（包括带回车符\r的光标控制、ANSI颜色转义码、百分比进度值），短时间输出量很容易冲爆管道缓冲区，子进程写输出时就直接挂起。
• 无明确触发规律：管道缓冲区被填满的阈值，和当前任务下进度条输出的总字符数强相关。当处理的文件数量、文件名长度刚好让输出量在缓冲区阈值附近波动时，就会出现时好时坏的无规律表现——文件少时输出量没到阈值，流程能顺利跑完；文件稍多输出量超阈值，就触发阻塞。
• 你当前的调用代码进一步放大了阻塞风险：
  • 代码逻辑顺序错误：先执行p.waitFor()等待子进程退出，才开始读取管道输出。也就是说只要子进程写满管道卡在输出阶段，就永远不会进入退出状态，父进程会永远卡在waitFor()调用上，形成双向死锁。
  • 流读取方式错误：哪怕把读流的位置挪到waitFor()之前，串行读错误流、再读输入流的逻辑依然会触发阻塞——如果子进程先把错误流的缓冲区写满，父进程还在等待读取输入流的内容，照样会触发双向阻塞。

已排查项的合理性说明 #

你之前排除的几类可能性，确实都和这个问题无关：

• 系统资源不足：管道阻塞是用户态的程序死锁，进程不消耗额外CPU、内存，磁盘空间也不受影响。
• 文件权限问题：阻塞发生在输出写管道的环节，和后续文件操作的权限校验无关联，引擎在挂起前的文件创建、写入操作自然能正常执行。
• 网络访问问题：管道是本地内存通信，不涉及网络交互，哪怕把引擎jar从文件服务器移到本地运行，阻塞条件依然存在。
• JRE版本兼容问题：旧版本引擎只是因为输出量小没触发阻塞，同版本JRE下这个问题的触发条件完全一致。

可落地修复方案 #

方式1：修正父进程的流读取逻辑 #

子进程启动后，必须立刻为stdout、stderr分别启动独立的守护线程，持续消费管道输出内容，最后再调用waitFor()等待进程退出，参考代码如下：

String commandString = "java -jar engine.jar script.xml input_file1.txt input_file2.txt input_file3.txt";
String[] command = {"bash", "-c", commandString};
ProcessBuilder pb = new ProcessBuilder(command);
Process p = pb.start();

// 独立线程消费stderr，避免错误流管道写满阻塞
Thread errConsumer = new Thread(() -> {
    try (BufferedReader e = new BufferedReader(new InputStreamReader(p.getErrorStream()))) {
        String line;
        while ((line = e.readLine()) != null) {
            System.out.println("[引擎错误流] " + line);
        }
    } catch (IOException ex) {
        // 进程退出后流会自动关闭，捕获异常即可
    }
});
errConsumer.setDaemon(true);
errConsumer.start();

// 独立线程消费stdout，避免标准输出流管道写满阻塞
Thread outConsumer = new Thread(() -> {
    try (BufferedReader i = new BufferedReader(new InputStreamReader(p.getInputStream()))) {
        String line;
        while ((line = i.readLine()) != null) {
            System.out.println("[引擎输出流] " + line);
        }
    } catch (IOException ex) {
        // 进程退出后流会自动关闭，捕获异常即可
    }
});
outConsumer.setDaemon(true);
outConsumer.start();

// 所有流消费线程启动完成后，再等待进程退出
int exitCode = p.waitFor();
p.destroy();

方式2：简化流处理逻辑 #

JDK 7+的ProcessBuilder提供了管道重定向的便捷方法，可以直接把子进程的stdout、stderr绑定到父进程对应的输出流，完全省去手动读流的代码：

ProcessBuilder pb = new ProcessBuilder(command);
// 将子进程的标准输出、错误流直接重定向到当前Java进程的对应流
pb.redirectOutput(ProcessBuilder.Redirect.INHERIT);
pb.redirectError(ProcessBuilder.Redirect.INHERIT);
Process p = pb.start();
int exitCode = p.waitFor();

快速验证方法 #

不用修改业务代码，只要把原来启动引擎的命令做临时调整，给输出加本地文件重定向，比如把原命令字符串改成：
java -jar engine.jar script.xml input_file1.txt input_file2.txt input_file3.txt > /tmp/engine_debug.log 2>&1
如果调整后引擎再也不出现挂起问题，就可以100%确认是管道缓冲区阻塞导致的异常。

内容的提问来源于stack exchange，提问作者NAMS