Java ScriptEngineManager运行带导入的Python脚本报错解决方案

你通过ScriptEngineManager.getEngineByName("python")获取的执行引擎是Jython，这是运行在JVM上的独立Python实现，和你本地通过pip安装依赖的CPython环境完全隔离，默认不会读取本地CPython的第三方包路径，因此会报依赖缺失错误。
另外你的代码中配置了Options.importSite = false;，直接关闭了Jython自身的site包路径扫描逻辑，进一步阻断了依赖加载路径。
需要特别注意：Jython本身不支持numpy、pandas这类包含C扩展的第三方包，哪怕你给Jython单独装包也无法运行这类依赖。

方案1：调用本地CPython进程执行（推荐，100%兼容所有依赖） #

这是稳定性最高、适配所有Python第三方包的方案，不依赖JVM内置的脚本引擎，直接启动本地Python解释器进程执行脚本，完全复用你本地已经调试好的Python环境，不会出现依赖找不到的问题。
示例代码：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;

public void runScript(String filePath) throws Exception {
    // 替换为你本地可正常运行目标脚本的Python解释器绝对路径
    // Windows示例：C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python310\\python.exe
    // Linux/macOS示例：/usr/local/bin/python3
    String pythonExePath = "你的本地Python解释器绝对路径";
    ProcessBuilder pb = new ProcessBuilder(pythonExePath, Path.of(filePath).toAbsolutePath().toString());
    pb.redirectErrorStream(true);
    Process process = pb.start();
    
    StringBuilder output = new StringBuilder();
    try (BufferedReader br = new BufferedReader(
            new InputStreamReader(process.getInputStream(), StandardCharsets.UTF_8))) {
        String line;
        while ((line = br.readLine()) != null) {
            output.append(line).append(System.lineSeparator());
        }
    }
    
    int exitCode = process.waitFor();
    if (exitCode != 0) {
        throw new RuntimeException("Python脚本执行异常，退出码：" + exitCode + "，输出：" + output);
    }
    System.out.println(output);
}

方案2：调整Jython配置（仅适用于纯Python实现的依赖） #

如果你的脚本没有用到numpy、pandas这类带C扩展的包，全是纯Python代码，可以通过调整Jython配置加载依赖：

• 删除代码中的Options.importSite = false;配置，恢复Jython的site包扫描能力
• 使用Jython自带的包管理工具安装所需依赖，不要用本地CPython的pip
• 如果仍无法识别依赖，手动将Jython的site-packages路径追加到Python系统路径中，代码示例：

// 在eval你的业务脚本前，追加路径配置
engine.eval("import sys\nsys.path.append('Jython对应site-packages文件夹的绝对路径')");

注意：该方案完全无法运行包含C扩展的Python包，涉及numpy、pandas等数据科学类依赖时不要使用。

方案3：替换ScriptEngine实现为GraalPy #

如果必须在JVM脚本引擎层面直接执行Python（不单独起进程），可以将Jython替换为GraalVM生态的GraalPy实现，它对Python生态的兼容性远高于Jython，支持numpy、pandas等大部分带C扩展的包，需要引入GraalPy相关依赖后替换原有引擎即可，但配置复杂度较高，对少量冷门C扩展包的兼容性仍不如直接调用本地CPython进程。

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