Java--ProcessBuilder操作系统进程

在 Java 开发中，经常需要调用系统命令、Shell 脚本、可执行程序、第三方二进制工具完成业务操作，例如文件批量处理、压缩解压、FFmpeg 音视频处理、Git 命令执行、系统运维操作等。

Java 提供了两套进程调用方案：Runtime.exec() 和 ProcessBuilder 。其中 ProcessBuilder 是 JDK1.5 推出的现代化进程工具类，位于 java.lang 包，具备参数可控、环境可配、目录可改、流可重定向、线程安全、不易阻塞等优势，完全替代老旧的 Runtime 方案，是生产环境唯一推荐的外部进程调用方式。

本文将从零拆解 ProcessBuilder 核心用途、三种构造方式、全量API、重定向原理、阻塞死锁根源、跨平台适配、命令注入漏洞、生产最佳实践、常见问题排查，一篇吃透Java外部进程编程。

一、ProcessBuilder 核心概述与适用场景

1.1 核心定位

ProcessBuilder 是 Java 用于创建和管理操作系统子进程的工具类，采用建造者模式，支持链式配置，可精细化控制子进程的执行环境、工作目录、输入输出流、超时终止等全生命周期。

1.2 核心用途

启动操作系统原生命令（ls、dir、ping、netstat）
执行 Shell / Bat 脚本、第三方可执行程序
自定义子进程工作目录、独立环境变量
重定向标准输出、错误输出、标准输入
获取进程执行结果、退出码、实时日志
超时终止、强制销毁失控子进程

1.3 与 Runtime.exec() 核心区别

Runtime.exec() ：老旧API，功能单一、不支持精细化配置、极易阻塞、存在安全漏洞，不推荐生产使用
ProcessBuilder：支持环境变量、工作目录、流重定向、超时控制、链式调用、安全性更高，是企业级标准方案

二、三大构造方法（规范传参，杜绝漏洞）

ProcessBuilder 核心设计：命令与参数分离，禁止字符串拼接整行命令，从根源避免命令注入漏洞。

2.1 无参构造器（后置设置命令）

java 复制代码

// 空构造，后续通过 command 设置指令
ProcessBuilder pb = new ProcessBuilder();
pb.command("ls", "-l", "/home");

2.2 可变参数构造器（最常用）

ini 复制代码

// 第一个参数为命令，后续全部为参数，严格分离
ProcessBuilder pb = new ProcessBuilder("ls", "-l", "/");

2.3 List 集合构造器（适配动态参数）

ini 复制代码

List<String> commandList = Arrays.asList("ls", "-l", "/usr/local");
ProcessBuilder pb = new ProcessBuilder(commandList);

2.4 链式编程规范写法（生产推荐）

ProcessBuilder 支持链式配置，代码简洁优雅，是生产标准写法：

arduino 复制代码

Process process = new ProcessBuilder("ls", "-l")
        .directory(new File("/home"))       // 指定工作目录
        .redirectErrorStream(true)          // 合并错误流与输出流
        .start();                           // 启动子进程

三、核心API方法全解

3.1 directory()：指定进程工作目录

默认子进程工作目录为 JVM 启动目录，可手动指定独立工作目录，适配脚本、相对路径执行场景。

arduino 复制代码

pb.directory(new File("/usr/local/script"));

3.2 environment()：自定义进程环境变量

子进程默认继承父进程环境变量，可单独增删改，实现进程环境隔离。

3.3 start()：启动子进程

3.4 三大数据流方法（阻塞核心考点）

getInputStream() ：读取子进程标准输出流（正常日志）
getOutputStream() ：向子进程写入标准输入数据

arduino 复制代码

try (BufferedReader reader = new BufferedReader(
        new InputStreamReader(process.getInputStream(), StandardCharsets.UTF_8))) {
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println("进程输出：" + line);
    }
}

支持将输入输出直接绑定文件或继承父进程，无需手动读写流，彻底解决阻塞问题。

redirectOutput(File) ：输出日志写入文件（覆盖）
Redirect.INHERIT：继承Java控制台输出，直接打印到终端

3.6 waitFor()：阻塞等待进程执行完毕

arduino 复制代码

// 无超时：永久等待
int exitCode = process.waitFor();

// 带超时：10秒未执行完则强制终止
if (process.waitFor(10, TimeUnit.SECONDS)) {
    System.out.println("进程正常结束");
} else {
    // 超时强制销毁
    process.destroyForcibly();
    System.out.println("进程执行超时，强制终止");
}

0：进程执行成功

注意：进程未结束调用会抛出异常，必须配合 waitFor 使用。

destroy() ：温柔终止，允许进程收尾释放资源

四、生产安全与最佳实践（避坑核心）

4.1 杜绝命令注入漏洞（高危）

漏洞原因 ：直接拼接用户输入字符串作为命令，攻击者可拼接 ; rm -rf /、| curl 恶意脚本等命令入侵服务器。

解决方案：

严格使用参数分离式传参，禁止整行字符串传入
用户输入做白名单校验，仅允许合法字符
禁止用户可控内容直接进入命令参数

4.2 跨平台兼容方案

Windows 与 Linux 命令体系不同，通过系统判断适配跨平台命令：

typescript 复制代码

public static ProcessBuilder getOsProcessBuilder() {
    String os = System.getProperty("os.name").toLowerCase();
    if (os.contains("win")) {
        return new ProcessBuilder("cmd.exe", "/c", "dir");
    } else {
        return new ProcessBuilder("sh", "-c", "ls -l");
    }
}

4.3 资源自动释放（try-with-resources）

IO 流必须手动关闭，推荐 JDK7+ 自动关闭语法，杜绝资源泄露。

arduino 复制代码

Process process = new ProcessBuilder("ls", "-l")
        .redirectErrorStream(true)
        .start();

// 自动关闭流资源
try (BufferedReader reader = new BufferedReader(
        new InputStreamReader(process.getInputStream(), StandardCharsets.UTF_8))) {
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println(line);
    }
}

// 等待执行结束
process.waitFor();
// 关闭进程
process.destroy();

4.4 解决进程阻塞死锁终极方案

子进程输出量大、缓冲区溢出，主线程同步读取会卡死。

生产两种解决方案：

使用 redirectErrorStream(true) 合并流，减少读取压力
开启异步线程读取输出流，主线程只管等待结束
配置超时时间，防止进程永久挂起

五、高频问题答疑

Q1：进程执行无输出、程序卡死？

核心原因：输出流/错误流缓冲区已满，未及时消费。

必须读取流数据或重定向流，否则子进程永久阻塞。

Q2：如何执行管道命令、复杂组合命令？

Java 本身不支持管道符，需依托系统 Shell 执行，将完整命令交给 sh/cmd 解析：

ini 复制代码

// Linux 执行 ps | grep java
ProcessBuilder pb = new ProcessBuilder("sh", "-c", "ps aux | grep java");

Q3：ProcessBuilder 与 Runtime.exec 怎么选？

生产一律使用 ProcessBuilder，功能更强、更安全、更稳定，Runtime.exec 仅适用于老旧兼容场景。

六、完整实战案例：执行管道命令并打印日志

java 复制代码

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;

public class ProcessBuilderDemo {
    public static void main(String[] args) throws Exception {
        // 执行复杂管道命令
        ProcessBuilder pb = new ProcessBuilder("sh", "-c", "ls | grep .txt");
        // 合并错误流
        pb.redirectErrorStream(true);
        Process process = pb.start();

        // 读取输出日志
        try (BufferedReader reader = new BufferedReader(
                new InputStreamReader(process.getInputStream(), StandardCharsets.UTF_8))) {
            String line;
            while ((line = reader.readLine()) != null) {
                System.out.println("结果：" + line);
            }
        }

        // 等待执行完毕
        boolean success = process.waitFor(5, java.util.concurrent.TimeUnit.SECONDS);
        if (!success) {
            process.destroyForcibly();
            System.out.println("命令执行超时");
        }

        System.out.println("退出码：" + process.exitValue());
    }
}

七、总结

ProcessBuilder 是 Java 操作系统进程的标准方案，替代老旧 Runtime，支持精细化配置进程环境、目录、数据流。
进程阻塞、卡死的根本原因是流缓冲区未消费，生产必须读取流或重定向流，同时配置超时控制。
安全核心：参数分离、禁止字符串拼接、白名单校验，彻底杜绝命令注入漏洞。
生产规范：链式配置、try-with-resources 释放资源、超时销毁、跨平台适配、流合并输出。