PyInstaller打包Python程序为exe时无法引入FoxitPDFSDKPython3模块求助

问题根源 #

FoxitPDFSDKPython3内部依赖fsdk模块（通常是C扩展或动态链接库），PyInstaller默认无法自动识别并打包这类非纯Python依赖，仅添加--hidden-import=FoxitPDFSDKPython3无法覆盖内部嵌套的fsdk依赖。

解决方案 #

1. 直接添加fsdk作为隐式导入参数 #

先尝试指定缺失的模块本身作为隐式导入：

pyinstaller.exe --onefile --hidden-import=FoxitPDFSDKPython3 --hidden-import=fsdk ./filename.py

2. 手动打包SDK完整目录 #

如果上述方法无效，需将整个FoxitPDFSDKPython3安装目录纳入打包范围：

• 找到Python环境中FoxitPDFSDKPython3的安装路径（通常在Lib/site-packages/FoxitPDFSDKPython3）
• 使用--add-data参数打包目录：

  # Windows系统用分号分隔源路径和目标路径
  pyinstaller.exe --onefile --add-data "C:\PythonXX\Lib\site-packages\FoxitPDFSDKPython3;FoxitPDFSDKPython3" ./filename.py
  
  # 虚拟环境下替换为对应site-packages路径
  

3. 通过spec文件精细控制打包（推荐） #

如需更灵活的配置，生成并编辑spec文件：

1. 生成spec文件：

   pyi-makespec ./filename.py
   

2. 打开生成的filename.spec，修改datas和hiddenimports字段：

   a = Analysis(
       ['filename.py'],
       pathex=[],
       binaries=[],
       # 添加SDK目录到打包资源
       datas=[('C:\\PythonXX\\Lib\\site-packages\\FoxitPDFSDKPython3', 'FoxitPDFSDKPython3')],
       # 显式声明需要导入的隐藏模块
       hiddenimports=['FoxitPDFSDKPython3', 'fsdk'],
       ...
   )
   

3. 基于spec文件打包：

   pyinstaller.exe ./filename.spec
   

4. 适配动态链接库路径（若仍报错） #

如果运行exe时提示找不到dll文件，需在代码中适配打包后的临时路径：

import sys
import os

# 区分开发环境与打包环境的SDK路径
if getattr(sys, 'frozen', False):
    # 打包后exe运行时的临时目录
    sdk_dir = os.path.join(sys._MEIPASS, 'FoxitPDFSDKPython3')
else:
    # 开发环境下的SDK路径
    sdk_dir = os.path.dirname(os.path.abspath(__file__))

# 将SDK目录加入系统路径，确保fsdk可被找到
sys.path.append(sdk_dir)

# 导入FoxitSDK模块
from FoxitPDFSDKPython3 import *

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