Spring Boot调用Python脚本无执行效果问题求助

核心问题分析 #

你的代码在普通Java项目能正常运行，但Spring Boot中无响应，最常见原因是进程的标准输出/错误输出缓冲区被占满，导致进程阻塞。proc.waitFor()会等待进程终止，但如果Python脚本产生的输出（尤其是错误信息）没有被及时读取，缓冲区满后进程会挂起，永远无法结束。

修复步骤与代码示例 #

1. 优先处理进程的输入输出流

必须在调用waitFor()前，启动线程读取stdout和stderr，避免缓冲区阻塞。推荐使用ProcessBuilder替代Runtime.exec，它能更方便地管理进程流：

@GetMapping("test")
public String test() {
    System.out.println(1);
    StringBuilder result = new StringBuilder();
    ProcessBuilder pb = new ProcessBuilder(
            "D:\\anaconda\\python.exe",
            "D:/2017/Python/pythonProject8/main.py",
            "D:\\2017\\Python\\pythonProject8\\flower3.jpg"
    );
    // 合并错误流到输出流，方便统一读取
    pb.redirectErrorStream(true);

    try {
        Process proc = pb.start();
        // 读取输出流的线程
        new Thread(() -> {
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(proc.getInputStream()))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    System.out.println(line);
                    result.append(line);
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }).start();

        // 等待进程结束，设置超时时间避免无限阻塞
        int exitCode = proc.waitFor(60, TimeUnit.SECONDS);
        System.out.println("Python脚本执行退出码: " + exitCode);
    } catch (IOException | InterruptedException e) {
        e.printStackTrace();
        return "执行失败: " + e.getMessage();
    }
    System.out.println(2);
    return result.toString();
}

2. 检查运行环境与权限

• 确认Spring Boot进程的运行用户有执行Python.exe、读取Python脚本和访问图片文件的权限；
• 所有路径使用绝对路径，避免因Spring Boot工作目录（如jar包所在目录）与普通Java项目不同导致的路径找不到问题；
• 若为Linux/macOS环境，需检查Python脚本的可执行权限，路径分隔符统一用/。

3. 添加超时与错误日志

在waitFor()中设置超时时间（如示例中的60秒），避免因Python脚本异常导致接口无限挂起；同时打印进程退出码，帮助排查脚本是否真的执行（退出码0通常表示成功，非0表示脚本执行出错）。

为什么普通Java项目能运行？ #

普通Java项目中，Python脚本的输出量可能较小，缓冲区还没满进程就执行完毕了，所以不会触发阻塞。但Spring Boot的Tomcat容器环境下，进程的流处理机制更严格，容易出现缓冲区阻塞问题。

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