PyInstaller打包后docx2pdf转换失败，换模块仍遇问题求助

核心原因分析 #

docx2pdf本质是调用本地Word（或LibreOffice）实例完成转换，打包成exe后大概率是这几个问题导致报错：

• PyInstaller没正确收集docx2pdf依赖的COM组件路径
• 程序运行时找不到Word的安装路径
• 临时生成的Word文档存在路径权限或识别问题

解决方案步骤 #

1. 显式指定Word程序路径 #

调用转换前手动指定Word的执行路径，避免打包后找不到程序：

from docx2pdf import convert
import win32com.client

# 替换成你实际的Word安装路径
word_path = r"C:\Program Files\Microsoft Office\root\Office16\WINWORD.EXE"
word = win32com.client.DispatchEx("Word.Application")
word.Visible = False

# 转换时传入指定的Word实例
convert("input.docx", "output.pdf", word=word)
word.Quit()

2. 调整PyInstaller打包参数 #

打包时必须确保包含docx2pdf和win32com的依赖，同时规避路径问题：

• 用--hidden-import显式导入缺失的模块：

pyinstaller --onefile --windowed --hidden-import=docx2pdf --hidden-import=win32com.client --hidden-import=win32com.client.gencache your_script.py

• 单文件打包时，docx2pdf可能在临时目录读写异常，建议把输出路径指定为用户可见的绝对路径（比如桌面）：

import os
from pathlib import Path

# 获取用户桌面路径
desktop_path = Path(os.path.expanduser("~/Desktop"))
output_pdf = desktop_path / "result.pdf"
convert("input.docx", str(output_pdf))

3. 修复win32com的gencache问题 #

打包后win32com的gencache可能无法正常生成，在代码开头加这段修复：

import sys
import win32com.client

# 解决打包后的gencache加载问题
if hasattr(sys, '_MEIPASS'):
    import win32com.client.gencache
    win32com.client.gencache.EnsureDispatch("Word.Application")

4. 无水印替代方案 #

如果上面的方法都不行，可以用libreoffice-convert替代，它不依赖Word，打包稳定性更高：

import libreofficeconvert as lo_convert

# 转换docx到pdf
lo_convert.convert("input.docx", "output.pdf", fmt="pdf")

注意：用户机器需要安装LibreOffice，也可以打包时附带便携版LibreOffice并指定路径。

排查要点 #

• 打包后的exe尽量以管理员权限运行，避免路径读写权限不足
• 检查日志里的临时文件路径，确认生成的docx文件是否正常
• 手动打开生成的docx文件，排除文档损坏的可能

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