Runtime.getRuntime().exec()问题排查：Maven Spring Boot项目导出.jar后部分终端命令无法执行

我之前也遇到过完全一样的情况——系统级命令比如shutdown now能正常跑，但xdg-open这类需要调用桌面组件的命令就毫无反应。核心问题其实很简单：图形化命令依赖桌面会话的环境变量，而Spring Boot Jar在运行时（尤其是命令行启动）往往没继承这些变量。

下面是我亲测有效的解决方法：

1. 关键：传递DISPLAY环境变量 #

xdg-open需要知道当前桌面的显示会话，这个信息存在DISPLAY环境变量里。你先在终端里执行echo $DISPLAY，会得到类似:0或者:1的结果，接下来用两种方式把这个变量传给你的Jar进程：

方式一：启动Jar时直接指定 #

在启动命令里加上环境变量：

DISPLAY=:0 java -jar your-app.jar

把:0换成你刚才查到的实际值就行。

方式二：在代码里手动设置 #

修改你的ProcessBuilder代码，给进程添加DISPLAY变量，同时记得一定要读取错误流——之前你的代码只抓了标准输出，命令失败的关键错误信息都在错误流里，这能帮你快速排查问题：

public void runInTerminal(String cmd){
    ProcessBuilder processBuilder = new ProcessBuilder();
    // 注入DISPLAY环境变量，值根据你实际查到的填
    Map<String, String> env = processBuilder.environment();
    env.put("DISPLAY", ":0");
    
    processBuilder.command("bash", "-c", cmd);
    try {
        Process process = processBuilder.start();
        
        // 读取标准输出
        StringBuilder output = new StringBuilder();
        BufferedReader reader = new BufferedReader(
            new InputStreamReader(process.getInputStream()));
        String line;
        while ((line = reader.readLine()) != null) {
            output.append(line + "\n");
        }
        
        // 读取错误输出，这步非常重要！
        StringBuilder errorOutput = new StringBuilder();
        BufferedReader errorReader = new BufferedReader(
            new InputStreamReader(process.getErrorStream()));
        while ((line = errorReader.readLine()) != null) {
            errorOutput.append(line + "\n");
        }
        
        int exitVal = process.waitFor();
        if (exitVal == 0) {
            System.out.println("Success!");
            System.out.println(output);
        } else {
            System.out.println("Command failed, exit code: " + exitVal);
            System.out.println("Error details: " + errorOutput);
        }
    } catch (IOException e) {
        e.printStackTrace();
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
}

2. 确保用桌面用户运行Jar #

如果你用sudo或者其他用户启动Jar，xdg-open可能无法访问当前登录用户的桌面环境。尽量用你平时登录桌面的那个用户来启动Jar，不要切换身份。

3. 替代方案：直接调用浏览器（如果只是打开链接） #

如果你的需求只是打开网页，也可以跳过xdg-open，直接调用浏览器的可执行文件，比如：

// 用Chrome打开链接
processBuilder.command("google-chrome", "somelink.com");
// 或者Firefox
processBuilder.command("firefox", "somelink.com");

这种方式同样需要DISPLAY变量，但有时候比xdg-open更稳定。

另外提一句，ProcessBuilder比Runtime.exec()更推荐，它的API更灵活，能更好地控制环境变量和输入输出流，后续维护起来也更方便。

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