使用PyInstaller将PDFMiner脚本打包为exe时出现报错求助

嘿，我之前也踩过PyInstaller打包PDFMiner脚本的坑，你遇到的这个导入报错，大概率是PyInstaller的静态依赖分析没抓全PDFMiner的内部模块导致的。给你几个亲测有效的解决办法：

1. 在脚本中显式导入所有必要的PDFMiner子模块 #

PyInstaller有时候会漏掉那些不是直接在代码里显式引用的模块，你可以在脚本开头把PDFMiner的核心子模块都列出来导入，强制PyInstaller把它们打包进去：

# 在你的onlypdfminer.py开头添加这些导入
from pdfminer import *
from pdfminer.pdfparser import *
from pdfminer.pdfdocument import *
from pdfminer.pdfpage import *
from pdfminer.pdfinterp import *
from pdfminer.pdfdevice import *
from pdfminer.converter import *
from pdfminer.layout import *
from pdfminer.image import *

添加完之后重新打包试试，很多时候这个方法就能解决问题。

2. 用PyInstaller的--hidden-import参数指定缺失模块 #

如果不想修改脚本，也可以在打包命令里直接告诉PyInstaller要包含哪些PDFMiner模块。打开终端运行：

pyinstaller --hidden-import=pdfminer --hidden-import=pdfminer.pdfparser --hidden-import=pdfminer.pdfdocument --hidden-import=pdfminer.pdfpage --hidden-import=pdfminer.pdfinterp --hidden-import=pdfminer.pdfdevice --hidden-import=pdfminer.converter --hidden-import=pdfminer.layout --hidden-import=pdfminer.image onlypdfminer.py

要是你经常打包这个脚本，更高效的方式是生成一个.spec文件，修改其中的hiddenimports列表：

1. 先生成.spec文件：pyinstaller onlypdfminer.py
2. 打开生成的onlypdfminer.spec，找到hiddenimports这一行，改成：

hiddenimports=['pdfminer', 'pdfminer.pdfparser', 'pdfminer.pdfdocument', 'pdfminer.pdfpage', 'pdfminer.pdfinterp', 'pdfminer.pdfdevice', 'pdfminer.converter', 'pdfminer.layout', 'pdfminer.image']

3. 再用.spec文件打包：pyinstaller onlypdfminer.spec

3. 确保依赖版本兼容 #

另外，建议检查一下你的PyInstaller和PDFMiner版本，老版本可能存在兼容性问题。优先使用最新版的PyInstaller和pdfminer.six（这是PDFMiner的维护分支，功能更全）：

pip install --upgrade pyinstaller pdfminer.six

更新完依赖后再重新打包，说不定问题就直接消失了。

补充说明 #

PyInstaller是通过静态扫描代码来收集依赖的，但PDFMiner内部可能用到了动态导入或者一些间接引用的模块，这些都是PyInstaller静态分析抓不到的，所以需要我们手动指定这些“隐藏”的导入项，确保所有必要的模块都被打包进EXE里。

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