Java作为跨平台的编程语言,在很多场景下需要和操作系统底层交互,调用Shell脚本就是常见的需求之一。无论是执行简单的系统命令,还是运行复杂的自动化脚本,Java都提供了对应的实现能力。

使用Runtime类调用Shell脚本
Runtime类是Java中与运行时环境交互的核心类,每个Java应用都有一个对应的Runtime实例,可以通过Runtime.getRuntime()方法获取。它提供了exec方法用于执行外部命令或脚本。
基础调用示例
以下是使用Runtime类调用本地Shell脚本的基础代码:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
public class RuntimeShellDemo {
public static void main(String[] args) {
// 要调用的Shell脚本路径
String scriptPath = "/home/test/demo.sh";
try {
// 执行脚本命令
Process process = Runtime.getRuntime().exec(new String[]{"/bin/sh", scriptPath});
// 获取脚本执行的标准输出流
InputStream inputStream = process.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
String line;
System.out.println("脚本输出结果:");
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
// 等待脚本执行完成,获取退出码
int exitCode = process.waitFor();
System.out.println("脚本执行退出码:" + exitCode);
} catch (IOException e) {
System.out.println("调用脚本IO异常:" + e.getMessage());
} catch (InterruptedException e) {
System.out.println("等待脚本执行中断:" + e.getMessage());
}
}
}
带参数调用示例
如果Shell脚本需要接收参数,只需要在命令数组中追加参数即可:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
public class RuntimeShellParamDemo {
public static void main(String[] args) {
String scriptPath = "/home/test/param_demo.sh";
// 参数1和参数2为传递给脚本的参数
String param1 = "hello";
String param2 = "world";
try {
// 命令数组:shell解释器、脚本路径、参数1、参数2
Process process = Runtime.getRuntime().exec(new String[]{"/bin/sh", scriptPath, param1, param2});
InputStream inputStream = process.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
int exitCode = process.waitFor();
System.out.println("执行退出码:" + exitCode);
} catch (IOException e) {
e.printStackTrace();
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
使用ProcessBuilder类调用Shell脚本
ProcessBuilder是Java 5之后引入的用于创建操作系统进程的类,相比Runtime类,它的功能更灵活,支持设置工作目录、环境变量等,是官方更推荐的进程调用方式。
基础调用示例
以下是使用ProcessBuilder调用Shell脚本的基础实现:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.ArrayList;
import java.util.List;
public class ProcessBuilderDemo {
public static void main(String[] args) {
String scriptPath = "/home/test/demo.sh";
// 构建命令列表
List<String> command = new ArrayList<>();
command.add("/bin/sh");
command.add(scriptPath);
try {
ProcessBuilder processBuilder = new ProcessBuilder(command);
// 设置工作目录,可选
// processBuilder.directory(new File("/home/test"));
Process process = processBuilder.start();
InputStream inputStream = process.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
String line;
System.out.println("脚本输出:");
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
int exitCode = process.waitFor();
System.out.println("退出码:" + exitCode);
} catch (IOException e) {
System.out.println("IO异常:" + e.getMessage());
} catch (InterruptedException e) {
System.out.println("中断异常:" + e.getMessage());
}
}
}
设置环境变量和获取错误流
ProcessBuilder可以很方便地设置环境变量,同时需要主动获取错误流,避免脚本执行错误时无法排查问题:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.HashMap;
import java.util.Map;
public class ProcessBuilderEnvDemo {
public static void main(String[] args) {
String scriptPath = "/home/test/env_demo.sh";
try {
ProcessBuilder processBuilder = new ProcessBuilder("/bin/sh", scriptPath);
// 设置自定义环境变量
Map<String, String> environment = processBuilder.environment();
environment.put("CUSTOM_VAR", "test_value");
// 合并标准错误流到标准输出流,方便统一处理
processBuilder.redirectErrorStream(true);
Process process = processBuilder.start();
InputStream inputStream = process.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
int exitCode = process.waitFor();
System.out.println("执行完成,退出码:" + exitCode);
} catch (IOException e) {
e.printStackTrace();
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
两种方式的对比
Runtime和ProcessBuilder都可以实现Java调用Shell脚本,两者的核心差异如下:
| 对比项 | Runtime类 | ProcessBuilder类 |
|---|---|---|
| 灵活性 | 较低,不支持直接设置工作目录和环境变量 | 较高,支持设置工作目录、环境变量、错误流合并等 |
| 使用复杂度 | 简单,直接调用exec方法即可 | 稍复杂,需要构建命令列表 |
| 官方推荐度 | 较旧的方式,后续维护较少 | Java 5之后引入,官方更推荐的方式 |
| 适用场景 | 简单的脚本调用,无额外环境配置需求 | 复杂场景,需要配置环境、工作目录的场景 |
调用时的注意事项
- 脚本需要有可执行权限,否则调用时会抛出权限拒绝的异常,可以通过
chmod +x 脚本路径命令添加权限。 - 必须主动处理脚本的标准输出流和错误流,否则如果输出内容较多,缓冲区满之后会导致进程阻塞,脚本无法正常执行完成。
- 调用
waitFor()方法会阻塞当前线程,直到脚本执行完成,如果脚本执行时间不确定,建议放在单独的线程中执行,避免阻塞主线程。 - 传递参数时如果包含特殊字符,需要做好转义处理,避免被Shell解释器误解析导致执行异常。
- 不同操作系统的Shell解释器路径不同,Linux系统一般是
/bin/sh或/bin/bash,Windows系统需要使用cmd.exe来执行批处理脚本。
常见问题排查
如果调用脚本后没有输出或者执行失败,可以按照以下步骤排查:
- 先手动在终端执行脚本,确认脚本本身可以正常运行,没有语法错误。
- 检查脚本路径是否正确,Java进程是否有访问该脚本的权限。
- 主动获取错误流内容,查看是否有执行错误信息,比如权限不足、命令不存在等。
- 如果是带参数的调用,检查参数传递是否正确,脚本中是否正确接收参数。
Javashell_scriptProcessBuilderRuntime脚本调用修改时间:2026-06-29 02:06:41