如何在Java运行时执行Python3脚本并打包Python3可执行文件？

这个需求其实挺常见的，尤其是要交付单文件给客户的场景。Jython确实只支持Python2，所以咱们得换个思路——把Python3的嵌入式版本打包进Jar，运行时动态解压并调用。下面是具体的实现步骤和注意点：

1. 准备Python3嵌入式包 #

首先你需要对应目标平台的Python嵌入式版本：

• Windows：从Python官网下载「Windows embeddable package (64-bit/32-bit)」，这是一个zip包，包含独立运行的Python解释器，无需安装。
• Linux：你需要静态编译Python（避免依赖系统库），编译时加上--enable-shared=no参数，确保生成不依赖系统libpython的可执行文件，再打包成tar.gz；也可以找现成的静态编译版本。
• macOS：类似Linux，需要编译无依赖的Python，或者用工具打包成独立框架后压缩成tar.gz。

如果要支持多平台，可以把不同平台的Python包都放进Jar里，运行时自动识别当前系统解压对应版本。

2. 整理资源文件 #

把下载/编译好的Python包和你的Python脚本放到Java项目的src/main/resources目录下，目录结构示例：

resources/
├─ python/
│  ├─ win/
│  │  └─ python3.11-embed-amd64.zip
│  ├─ linux/
│  │  └─ python3.11-static-x64.tar.gz
│  └─ mac/
│     └─ python3.11-static-arm64.tar.gz
└─ scripts/
   └─ my_script.py

3. Java代码：解压Python并执行脚本 #

核心逻辑是识别当前系统→解压对应Python包到临时目录→调用Python执行脚本，下面是简化版代码示例：

3.1 识别当前平台工具方法

private static String getPlatform() {
    String osName = System.getProperty("os.name").toLowerCase();
    String osArch = System.getProperty("os.arch").toLowerCase();
    
    if (osName.contains("win")) {
        return osArch.contains("64") ? "win/x64" : "win/x86";
    } else if (osName.contains("nix") || osName.contains("nux") || osName.contains("aix")) {
        return osArch.contains("64") || osArch.equals("amd64") ? "linux/x64" : "linux/arm64";
    } else if (osName.contains("mac")) {
        return osArch.equals("aarch64") || osArch.equals("arm64") ? "mac/arm64" : "mac/x64";
    }
    throw new UnsupportedOperationException("Unsupported platform: " + osName + " " + osArch);
}

3.2 解压Python包到临时目录

private static Path extractPythonToTempDir(String platform) throws IOException {
    // 创建临时目录
    Path tempDir = Files.createTempDirectory("python-embed-");
    
    // 读取Jar中的Python包资源（根据平台调整后缀）
    String resourcePath = "python/" + platform + "/python3.tar.gz";
    try (InputStream is = YourMainClass.class.getResourceAsStream("/" + resourcePath)) {
        if (is == null) {
            throw new IllegalArgumentException("No Python package found for platform: " + platform);
        }
        
        // 处理tar.gz（需引入Apache Commons Compress库）
        try (TarArchiveInputStream tais = new TarArchiveInputStream(new GZIPInputStream(is))) {
            TarArchiveEntry entry;
            while ((entry = tais.getNextTarEntry()) != null) {
                Path entryPath = tempDir.resolve(entry.getName());
                if (entry.isDirectory()) {
                    Files.createDirectories(entryPath);
                } else {
                    Files.copy(tais, entryPath, StandardCopyOption.REPLACE_EXISTING);
                    // Linux/macOS下添加执行权限
                    if (!System.getProperty("os.name").toLowerCase().contains("win")) {
                        Files.setPosixFilePermissions(entryPath, PosixFilePermissions.fromString("rwxr-xr-x"));
                    }
                }
            }
        }
        // Windows下处理zip包的逻辑类似，替换为ZipInputStream即可
    }
    
    return tempDir;
}

3.3 调用Python脚本

public static void runPythonScript() throws IOException, InterruptedException {
    String platform = getPlatform();
    Path tempPythonDir = extractPythonToTempDir(platform);
    
    // 定位Python可执行文件
    Path pythonExecutable = platform.startsWith("win")
            ? tempPythonDir.resolve("python.exe")
            : tempPythonDir.resolve("bin/python3");
    
    // 把Jar中的Python脚本解压到临时目录
    Path scriptPath = tempPythonDir.resolve("my_script.py");
    try (InputStream scriptIs = YourMainClass.class.getResourceAsStream("/scripts/my_script.py")) {
        Files.copy(scriptIs, scriptPath, StandardCopyOption.REPLACE_EXISTING);
    }
    
    // 执行Python脚本
    ProcessBuilder pb = new ProcessBuilder(pythonExecutable.toString(), scriptPath.toString());
    pb.redirectErrorStream(true); // 合并标准输出和错误输出
    Process process = pb.start();
    
    // 读取脚本输出（避免进程阻塞）
    try (BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()))) {
        String line;
        while ((line = reader.readLine()) != null) {
            System.out.println("Python output: " + line);
        }
    }
    
    int exitCode = process.waitFor();
    System.out.println("Python script exited with code: " + exitCode);
    
    // 注册ShutdownHook，JVM退出时清理临时目录
    Runtime.getRuntime().addShutdownHook(new Thread(() -> {
        try {
            Files.walk(tempPythonDir)
                 .sorted(Comparator.reverseOrder())
                 .forEach(path -> {
                     try { Files.delete(path); } catch (IOException e) { e.printStackTrace(); }
                 });
        } catch (IOException e) {
            e.printStackTrace();
        }
    }));
}

4. 关键注意事项 #

• 第三方依赖处理：如果你的Python脚本需要requests、numpy这类第三方库，要先把它们安装到嵌入式Python的site-packages目录再打包。比如Windows下解压嵌入式包后，运行python -m pip install requests --target ./Lib/site-packages，再重新打包zip。
• Jar打包配置：确保Maven/Gradle等构建工具把resources目录下的所有文件都打包进Jar，Maven的maven-resources-plugin、Gradle的processResources任务默认都会处理。
• Jar体积控制：Python嵌入式包加上依赖可能让Jar体积达到几十MB到上百MB，对大小敏感的话可以裁剪Python（比如去掉不必要的标准库）。
• 权限问题：Linux/macOS下解压后必须给Python可执行文件添加x权限，否则无法运行。

这样处理后，你只需要交付一个Jar包给客户，他们不需要预先安装Python3，程序会自动解压并使用内置的Python解释器执行脚本。

内容的提问来源于stack exchange，提问作者Less Experienced User