使用PyInstaller打包含ibm_db的Python脚本为EXE后DB2连接报错求解

核心问题分析 #

打包后出现SQL10007N错误，本质是DB2 CLI驱动在临时运行环境中找不到必要的依赖文件（消息文件、配置文件、DLL），即使开发环境中用os.add_dll_directory解决了导入问题，打包后的路径和环境变量仍不匹配。

详细解决方案 #

1. 强制PyInstaller打包完整的CLI驱动 #

使用--add-data参数将本地clidriver目录的所有关键子目录复制到打包后的程序中：

pyinstaller --onefile ^
--add-data "C:\path\to\your\clidriver\bin;clidriver\bin" ^
--add-data "C:\path\to\your\clidriver\lib;clidriver\lib" ^
--add-data "C:\path\to\your\clidriver\msg;clidriver\msg" ^
--add-data "C:\path\to\your\clidriver\cfg;clidriver\cfg" ^
your_script.py

注意：Windows系统用分号;分隔源路径和目标路径，Linux/macOS用冒号:；替换C:\path\to\your\clidriver为实际的CLI驱动安装路径。

2. 动态适配打包后的运行路径 #

修改脚本，自动识别打包状态，动态设置DLL目录和环境变量，避免硬编码本地路径：

import os
import sys

# 判断是否为打包后的运行环境
is_frozen = getattr(sys, 'frozen', False)
if is_frozen:
    # 打包后临时目录路径
    base_dir = sys._MEIPASS
    clidriver_path = os.path.join(base_dir, 'clidriver')
else:
    # 开发环境的CLI驱动路径
    clidriver_path = "C:\path\to\your\clidriver"

# 设置DLL加载目录
bin_path = os.path.join(clidriver_path, 'bin')
lib_path = os.path.join(clidriver_path, 'lib')
os.add_dll_directory(bin_path)
os.add_dll_directory(lib_path)

# 配置DB2环境变量，确保驱动能找到消息和配置文件
os.environ['IBM_DB_HOME'] = clidriver_path
os.environ['PATH'] = bin_path + os.pathsep + os.environ['PATH']

# 必须在环境变量配置完成后导入ibm_db
import ibm_db

# 后续DB2连接逻辑
conn = ibm_db.connect("DATABASE=your_db;HOSTNAME=your_host;PORT=50000;PROTOCOL=TCPIP;UID=user;PWD=pass;", "", "")

3. 验证打包文件完整性 #

打包完成后，可以用7-Zip等压缩工具打开生成的EXE文件，检查是否包含完整的clidriver目录（bin、lib、msg、cfg子目录都要存在）。如果缺失，调整--add-data参数补充对应目录。

4. 额外排查点 #

• 如果仍报错，检查连接字符串是否包含完整参数，避免依赖本地db2cli.ini配置；
• 确保打包用的Python环境和开发环境一致（同版本、同架构：32/64位）；
• 测试时关闭杀毒软件，避免临时目录的DLL被拦截。

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