SpringBoot中Process执行GitHub CLI命令返回exitValue=1而非JSON

核心问题分析 #

exitValue=1表示命令执行失败，当前代码存在几个关键问题：

• 未读取错误输出，无法定位具体失败原因
• 命令参数拆分错误，Runtime.exec(String)会按空格拆分命令，导致带特殊字符的jq表达式解析异常
• 实体类与JSON字段不匹配，且缺少getter/setter，Jackson无法完成序列化/反序列化
• 执行环境可能存在差异，比如gh命令路径未加入环境变量、未完成GitHub认证

分步解决方案 #

1. 读取错误输出定位问题 #

修改ProfileService代码，先读取错误流打印详情，明确失败原因：

public List<ProfileRepository> executeConsoleCommand(String command) throws IOException, InterruptedException {
    Process process = Runtime.getRuntime().exec(command);
    
    // 读取错误输出
    String errorOutput = new String(process.getErrorStream().readAllBytes(), StandardCharsets.UTF_8);
    process.waitFor();

    if(process.exitValue() != 0) {
        System.out.println("ERROR - exitValue() = " + process.exitValue());
        System.out.println("错误详情：" + errorOutput);
        return List.of();
    }

    String output = new String(process.getInputStream().readAllBytes(), StandardCharsets.UTF_8);
    return objectMapper.readValue(output, new TypeReference<List<ProfileRepository>>(){});
}

2. 正确传递命令参数 #

改用exec(String[])数组形式传递命令，避免参数拆分错误：

// 拆分命令为数组，jq参数无需额外加引号
String[] command = {
    "gh",
    "api",
    "/users/abcslawek/repos",
    "--jq",
    "map(select(.fork == false))|.[]|{Repository_name: .name, Owner_login: .owner.login}"
};
Process process = Runtime.getRuntime().exec(command);

3. 修正实体类适配Jackson #

修改ProfileRepository，添加字段映射注解并补充getter/setter：

package com.slaweklida.githubDataScrapper;

import com.fasterxml.jackson.annotation.JsonProperty;

// 移除@Repository注解，该类为数据传输对象而非数据库仓库组件
public class ProfileRepository {
    @JsonProperty("Repository_name")
    private String repositoryName;
    
    @JsonProperty("Owner_login")
    private String ownerLogin;

    public String getRepositoryName() {
        return repositoryName;
    }

    public void setRepositoryName(String repositoryName) {
        this.repositoryName = repositoryName;
    }

    public String getOwnerLogin() {
        return ownerLogin;
    }

    public void setOwnerLogin(String ownerLogin) {
        this.ownerLogin = ownerLogin;
    }
}

4. 确保执行环境正常 #

• 确认gh命令路径已加入系统环境变量，或直接使用绝对路径（如"C:\\Program Files\\GitHub CLI\\gh.exe"）
• 确保已完成gh认证：在运行SpringBoot的机器上执行gh auth login，或设置GH_TOKEN环境变量

完整修正后的ProfileService示例 #

package com.slaweklida.githubDataScrapper;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.stereotype.Service;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.util.List;

@Service
public class ProfileService {

    private final ObjectMapper objectMapper;

    public ProfileService() {
        this.objectMapper = new ObjectMapper();
    }

    public List<ProfileRepository> executeConsoleCommand() throws IOException, InterruptedException {
        String[] command = {
            "gh",
            "api",
            "/users/abcslawek/repos",
            "--jq",
            "map(select(.fork == false))|.[]|{Repository_name: .name, Owner_login: .owner.login}"
        };
        
        Process process = Runtime.getRuntime().exec(command);
        
        String errorOutput = new String(process.getErrorStream().readAllBytes(), StandardCharsets.UTF_8);
        process.waitFor();

        if(process.exitValue() != 0) {
            System.out.println("ERROR - exitValue() = " + process.exitValue());
            System.out.println("错误详情：" + errorOutput);
            return List.of();
        }

        String output = new String(process.getInputStream().readAllBytes(), StandardCharsets.UTF_8);
        return objectMapper.readValue(output, new TypeReference<List<ProfileRepository>>(){});
    }
}

同时修改Controller中的调用：

@GetMapping("/repo")
public List<ProfileRepository> getProfileRepositories() {
    try {
        return profileService.executeConsoleCommand();
    } catch (IOException | InterruptedException e) {
        e.printStackTrace();
        return List.of();
    }
}

验证结果 #

运行SpringBoot应用后访问http://localhost:8080/repo，即可得到与PowerShell中一致的JSON结果。若仍有问题，可通过控制台打印的错误详情进一步排查。

内容的提问来源于stack exchange，提问作者Sławomir Lida