Spring微服务调用Python脚本抛出RuntimeException脚本调用错误排查

从日志首行的报错文本（法语，存在编码乱码）可直接定位核心问题：运行微服务的环境找不到Python可执行程序，异常触发链路如下：

• 代码通过ProcessBuilder直接调用python命令执行时序预测训练脚本，但当前环境要么未安装Python，要么Python可执行文件未加入系统PATH，或是部分Linux/macOS环境中Python3的默认命令为python3而非python，导致系统直接返回命令不存在的错误提示
• 代码配置了pb.redirectErrorStream(true)，将进程的标准错误流合并到标准输出流，因此“找不到Python”的系统错误提示被完整读取到outputLines输出列表中
• 代码未校验Python进程的退出状态，也未判断输出内容格式，直接取输出列表最后一行传入Jackson做JSON解析，传入的内容是系统错误文本而非合法JSON，最终触发JsonParseException

1. 修复Python环境问题 #

• 登录运行微服务的主机/容器，分别执行python --version、python3 --version，确认Python是否安装、可用的命令名是什么
• 若未安装Python，安装脚本依赖的对应Python版本（需和time-series-training.py的版本要求匹配，绝大多数场景为Python3）
• 若已安装但执行python提示不存在，要么将Python可执行文件路径加入系统PATH环境变量，要么将代码中硬编码的python命令改为实际可用的命令名（如python3）
• 若微服务运行在Docker容器中，需要在镜像构建阶段（Dockerfile）安装Python依赖，不能仅在宿主机安装Python

2. 补全代码容错逻辑 #

原有代码缺少进程执行状态校验、输出合法性校验，遇到脚本执行错误时无法快速定位问题，将进程启动后的逻辑替换为如下代码即可：

/* Start the process */
Process proc = pb.start();
// 阻塞等待脚本执行完成，获取退出码
int exitCode = proc.waitFor();
/* Read the process's output */
List<String> outputLines = Utils.toStrings(proc.getInputStream());
/* Clean-up */
proc.destroy();
log.info(String.join("\n", outputLines));
// 非0退出码直接抛出异常，携带完整输出方便排障
if (exitCode != 0) {
    throw new RuntimeException("Python脚本执行失败，退出码：" + exitCode + "，输出信息：" + String.join("\n", outputLines));
}
// 校验输出非空，避免空列表取最后一行触发索引越界
if (outputLines.isEmpty()) {
    throw new RuntimeException("Python脚本执行完成但无任何输出");
}
ObjectMapper jackson = new ObjectMapper();
List<String> filesName = jackson.readValue(outputLines.get(outputLines.size() - 1), new TypeReference<List<String>>() {});

注意：proc.waitFor()会抛出InterruptedException，需要在现有catch块中补充捕获，捕获后建议通过Thread.currentThread().interrupt()恢复线程中断标记。

3. 可选优化项 #

• 将Python可执行路径、脚本存储路径抽离为配置项，不要硬编码在业务代码中，方便多环境适配
• 调整Python脚本的输出逻辑：将调试日志打印到标准错误流，仅将最终需要解析的JSON结果打印到标准输出流，替代现有“取输出最后一行”的逻辑，避免日志内容干扰JSON解析
• 初始化ProcessBuilder时显式指定工作目录，避免相对路径找不到脚本文件、输入文件的问题

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