Windows11下Python3.12.2连接DB2失败求助（db2cli已验证成功）

问题背景 #

• 系统：Windows 11
• 环境：Python 3.12.2，已安装ibm_db库
• 验证结果：通过db2cli可成功连接目标DB2实例，连接字符串已确认有效，但Python脚本调用ibm_db时连接失败
• 核心报错：

Exception: [IBM][CLI Driver] SQL1042C  An unexpected system error occurred.  SQLSTATE=58004  SQLCODE=-1042

可行解决步骤 #

1. 修正环境变量配置 #

• 补全IBM_DB_HOME环境变量：将其值设置为完整的clidriver路径 C:\HighmarkApps\Python3.12.2\Lib\site-packages\clidriver，而非仅保留变量名。
• 调整PATH优先级：把C:\HighmarkApps\Python3.12.2\Lib\site-packages\clidriver\bin移到PATH最前端，避免系统加载其他冲突的DB2驱动文件。
• 移除无效路径：从PATH中删除C:\HighmarkApps\Python3.12.2\Lib\site-packages\clidriver\bin\icc64，Windows环境下无需该IBM编译器依赖。

2. 修复VC运行时库依赖 #

• 检查amd64.VC12.CRT目录下的文件完整性，若缺失msvcr120.dll、msvcp120.dll等文件，下载安装Visual C++ Redistributable for Visual Studio 2013（x64版本），修复运行时依赖。

3. 调整Python连接代码格式 #

• 不要直接使用带引号的db2cli输出字符串，拆分参数或使用无DSN连接方式：

  import ibm_db
  
  # 方式1：拆分参数构建连接字符串
  conn_str = "DATABASE=xxxxxxxx;HOSTNAME=xxxxxxxx;PORT=447;PROTOCOL=TCPIP;UID=LIDDVDP;PWD=你的真实密码;SECURITY=SOCKETS;"
  conn = ibm_db.connect(conn_str, "", "")
  
  if conn:
      print("连接成功")
      ibm_db.close(conn)
  else:
      print("连接失败:", ibm_db.conn_errormsg())
  

4. 确保驱动与Python版本兼容 #

• 检查ibm_db版本：执行pip show ibm_db，若版本过旧，执行pip install --upgrade ibm_db更新到支持Python 3.12.2的最新版。
• 重新安装适配版本：先执行pip uninstall ibm_db，再执行pip install ibm_db --only-binary :all:，强制安装预编译的Windows适配包，避免源码编译异常。

5. 排查权限与防火墙问题 #

• 以管理员身份运行Python脚本：右键点击命令提示符/PowerShell，选择「以管理员身份运行」后执行脚本，规避权限不足导致的系统调用失败。
• 放行DB2端口：在Windows防火墙高级设置中，添加允许Python.exe访问目标DB2端口（447）的入站/出站规则，确保网络连接不受拦截。

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