如何在Java程序中运行PyInstaller打包的Python exe文件并解决报错问题

核心原因说明 #

你遇到的报错本质是Java启动的子进程运行上下文和手动运行exe的上下文不一致导致的：
手动运行exe是在当前用户的交互式Windows会话中，有完整的用户权限、环境变量、COM组件调用权限；而Java启动的子进程默认继承Java程序的运行上下文，容易出现权限不足、流阻塞、COM组件调用失败的问题，加上你使用--windowed参数打包禁用了控制台，也会导致标准输入输出流异常触发报错。

可落地的修复方案 #

1. 修复Java调用代码，处理子进程IO流 #

Java调用系统进程时如果不主动消费子进程的输出/错误流，会导致流缓冲区占满后子进程挂死甚至抛出异常，修改ProcessBuilder代码如下：

import java.io.File;
import java.io.IOException;
import java.io.InputStream;

public class ExeCaller {
    public static void main(String[] args) {
        File exeFile = new File("C:\\Users\\myUser\\test.exe");
        ProcessBuilder processBuilder = new ProcessBuilder(exeFile.getAbsolutePath());
        // 设置工作目录和exe所在目录一致
        processBuilder.directory(exeFile.getParentFile());
        // 合并输出流和错误流，统一消费避免阻塞
        processBuilder.redirectErrorStream(true);
        
        try {
            Process process = processBuilder.start();
            // 主动消费子进程的输出流，防止缓冲区满
            InputStream inputStream = process.getInputStream();
            while (inputStream.read() != -1) {
                // 不需要内容的话直接丢弃即可
            }
            // 等待exe执行完成，获取退出码
            int exitCode = process.waitFor();
            System.out.println("exe执行结束，退出码：" + exitCode);
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

2. 修改Python脚本，增加异常日志排查 #

你当前的报错信息只到convert调用行，看不到具体错误原因，修改Python代码把异常写入本地日志文件：

from docx2pdf import convert
import traceback

if __name__ == "__main__":
    try:
        input_path = "C:\\Users\\myUser\\test.docx"
        output_path = "C:\\Users\\myUser\\file.pdf"
        convert(input_path, output_path)
    except Exception as e:
        # 错误日志写入固定路径，方便排查
        with open("C:\\Users\\myUser\\exe_run.log", "w", encoding="utf-8") as log_file:
            log_file.write(f"错误信息：{str(e)}\n")
            log_file.write(f"堆栈信息：{traceback.format_exc()}")

修改后重新用原命令打包，运行Java代码触发报错后查看exe_run.log文件就能定位具体问题。

3. 调整pyinstaller打包参数测试 #

--windowed参数会禁用控制台窗口，同时会关闭标准输入输出流，容易触发IO相关的报错，你可以先改用带控制台的参数打包测试：
pyinstaller test.py --onefile --console
如果带控制台的版本可以正常被Java调用，说明是--windowed模式的流异常问题，确认功能正常后如果需要隐藏控制台窗口，可以再换回--windowed参数，同时在Python脚本开头增加标准流重定向代码即可。

4. 配置Word COM组件权限（如果日志显示COM调用失败） #

docx2pdf底层依赖Microsoft Word的COM组件实现转换，Java调用时如果权限不足会触发报错，按以下步骤配置权限：

• 按Win+R输入dcomcnfg回车打开组件服务
• 依次展开：组件服务 > 计算机 > 我的电脑 > DCOM配置
• 找到「Microsoft Word 应用程序」，右键选择「属性」
• 切换到「安全」标签页，把「启动和激活权限」「访问权限」都配置为你运行Java程序的用户，勾选所有允许选项
• 切换到「标识」标签页，选择「交互式用户」，保存设置即可。

注意事项 #

• 运行程序的设备必须安装Microsoft Word，docx2pdf无法在无Word的环境下运行，如果需要无依赖转换，建议换用不依赖COM的Python库重新开发转换功能
• 不要将Java程序作为Windows服务运行，Windows服务默认运行在会话0，没有权限调用用户态的COM组件，必须以普通用户交互式启动Java程序。

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