使用Python ibm_db模块连接Informix数据库时遇SQL30081N通信错误

运行环境 #

• 本地Python 3.12 64位
• Windows 11 家庭版

代码实现 #

import os

# 导入ibm_db前添加clidriver的dll路径
os.add_dll_directory('path_to_clidriver')
import ibm_db

cnx_string = 'DATABASE=database_name;HOSTNAME=hostname.com;PORT=9088;PROTOCOL=tcpip;UID=user;PWD=123;'

try:
    conn = ibm_db.connect(cnx_string, "", "")
    print("连接成功！")
except Exception as e:
    print(f"无法连接: {e}")
    exit()

ibm_db.close(conn)

报错信息 #

无法连接: [IBM][CLI驱动] SQL30081N 检测到通信错误。使用的通信协议："TCP/IP"。使用的通信API："SOCKETS"。检测到错误的位置："119.82.149.212"。检测到错误的通信函数："recv"。协议特定错误代码："", "", "0"。SQLSTATE=08001 SQLCODE=-30081
PS G:\My Drive\Python\ibm-db>

排查方向 #

1. 网络连通性检查
   • 用ping hostname.com或telnet hostname.com 9088测试目标主机和端口的可达性，Windows下未启用telnet可通过dism /online /enable-feature /featurename:TelnetClient命令开启
   • 检查本地防火墙、目标服务器防火墙是否开放9088端口，排查是否有代理、VPN等网络工具阻断连接
2. 连接参数验证
   • 确认DATABASE字段为正确的Informix数据库名，注意数据库名区分大小写
   • 核对HOSTNAME、PORT的准确性，Informix默认TCP/IP端口为9088，但部分环境可能修改
   • 验证UID和PWD的有效性，确保账号拥有远程访问该数据库的权限
3. CLIDriver配置
   • 确认path_to_clidriver指向64位版本的Informix CLIDriver目录（匹配Python 64位环境），建议使用绝对路径
   • 检查ibm_db和CLIDriver版本是否兼容Python 3.12，旧版本驱动可能不支持高版本Python，可尝试更新到最新版
4. Informix服务器状态
   • 确认目标Informix服务器处于运行状态，且已监听指定的TCP/IP端口
   • 查看Informix服务器日志（如online.log），排查服务器端是否有连接错误记录

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