Python连接Db2报错SQLCODE=-1042，寻求解决方案

问题背景 #

使用pip安装ibm_db后，连接Db2时抛出错误：

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

已尝试添加以下路径到sys.path但无效：

sys.path.append('C:\HighmarkApps\Python3.12.2\Lib\site-packages\clidriver\bin\amd64.VC12.CRT')
sys.path.append('C:\HighmarkApps\Python3.12.2\Lib\site-packages\clidriver\bin\icc64')

当前使用的连接字符串：

conn = ibm_db.connect("DATABASE=basename;HOSTNAME=hostname;PORT=999;PROTOCOL=TCPIP;UID=xxxxxxx;PWD=xxxxxxxxxxxxxx;","SECURITY=SSL;","SSLServerCertificate=C:\xxxxxxxxxxxx\Python3.12.2\Lib\site-packages\clidriver\cfg\DigiCertGlobalRootCA.arm")

排查与解决建议 #

1. 修正路径配置方式 #

sys.path是Python模块搜索路径，Db2 CLI驱动依赖的是系统环境变量PATH，而非sys.path。需将驱动路径添加到PATH：

import os
# 路径使用双反斜杠避免转义问题
os.environ['PATH'] += ';C:\\HighmarkApps\\Python3.12.2\\Lib\\site-packages\\clidriver\\bin\\amd64.VC12.CRT'
os.environ['PATH'] += ';C:\\HighmarkApps\\Python3.12.2\\Lib\\site-packages\\clidriver\\bin\\icc64'

也可直接在系统环境变量的PATH中添加这两个路径，之后重启Python解释器。

2. 修复证书路径问题 #

• 证书路径需用双反斜杠或原始字符串，避免转义字符解析错误：

  # 原始字符串写法
  cert_path = r'C:\xxxxxxxxxxxx\Python3.12.2\Lib\site-packages\clidriver\cfg\DigiCertGlobalRootCA.arm'
  # 双反斜杠写法
  cert_path = 'C:\\xxxxxxxxxxxx\\Python3.12.2\\Lib\\site-packages\\clidriver\\cfg\\DigiCertGlobalRootCA.arm'
  

• 若路径过长或权限受限，可将证书复制到更简单的目录（如C:\temp\DigiCertGlobalRootCA.arm）后再引用。

3. 调整连接字符串格式 #

ibm_db.connect的参数格式有误，额外连接属性需合并到第一个参数的连接字符串中，第二个参数留空：

conn_str = (
    "DATABASE=basename;"
    "HOSTNAME=hostname;"
    "PORT=999;"
    "PROTOCOL=TCPIP;"
    "UID=xxxxxxx;"
    "PWD=xxxxxxxxxxxxxx;"
    "SECURITY=SSL;"
    f"SSLServerCertificate={cert_path}"
)
conn = ibm_db.connect(conn_str, "", "")

4. 重新安装并验证驱动完整性 #

• 卸载当前ibm_db，重新安装稳定版本，避免驱动文件损坏：

  pip uninstall -y ibm_db
  pip install ibm_db==3.2.3  # 可替换为最新稳定版
  

• 检查clidriver目录下的bin、cfg、lib等子目录是否完整，若缺失可手动下载对应版本的Db2 CLI驱动覆盖。

5. 补充依赖与检查权限 #

• 安装Visual Studio 2013对应的VC++ Redistributable运行库（对应驱动的VC12标识），确保驱动依赖的运行环境完整。
• 确认Python进程有访问clidriver目录和证书文件的权限，必要时以管理员身份运行脚本。

6. 启用CLI日志定位细节 #

添加环境变量开启Db2 CLI日志，获取更详细的错误信息：

os.environ['DB2CLIINIPATH'] = 'C:\\HighmarkApps\\Python3.12.2\\Lib\\site-packages\\clidriver\\cfg'
os.environ['DB2TRACE'] = 'CLI=1'
os.environ['DB2TRACEDIR'] = 'C:\\temp\\db2trace'  # 需先创建该目录

运行脚本后查看生成的日志文件，定位具体系统错误原因。

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