使用Python ibm_db配置IBM连接器连接DB2 AS400报SQL30081N错误

首先明确错误本质：10060是操作系统返回的TCP连接超时错误，代表客户端发起的连接请求没有在规定时间内收到目标服务的响应，故障发生在TCP握手阶段，和数据库账号权限、SQL语法、库表配置没有关系，按以下顺序逐层排查：

• 先核对地址不一致问题：你代码里填写的目标地址是10.56.4.20，但报错信息里错误检测位置是10.16.1.10，先检查本地是否配置了DB2节点目录别名、系统hosts文件、全局网络代理把目标地址重定向到了其他IP。优先在命令行执行路由追踪和端口测试：Windows环境执行tracert 10.56.4.20看路由路径、telnet 10.56.4.20 你配置的端口测端口连通性；Linux/macOS环境执行nc -zv 10.56.4.20 你配置的端口测试。如果端口测试直接超时，先联系网络管理员检查两端防火墙策略、路由规则，确认客户端IP在AS/400侧的访问白名单内。
• 核对AS/400侧服务端口配置：DB2 for i的DRDA原生服务默认监听端口是446，8476是IBM i Access主机服务的端口，不适用于ibm_db的DRDA直连。联系AS/400管理员在主机端执行NETSTAT *CNN查看当前处于LISTEN状态的端口列表，确认DB2 DRDA服务实际监听的端口号、绑定的IP地址，确认服务没有只绑定回环地址或其他非目标网卡IP。
• 修正连接串配置：你当前使用的连接串缺少AS/400连接必要的兼容参数，可参考以下最简配置替换对应参数后测试：

import ibm_db
conn_str = (
    "DATABASE=AS400侧实际配置的RDB数据库名;"
    "HOSTNAME=10.56.4.20;"
    "PORT=446;" # 替换为管理员确认的实际DRDA端口，不要默认填8476
    "PROTOCOL=TCPIP;"
    "UID=你的数据库账号;"
    "PWD=你的数据库密码;"
    "CCSID=1208;" # 指定UTF-8编码，减少握手阶段的编码协商异常
)
connection = ibm_db.connect(conn_str, "", "")

• 排查本地环境兼容性：确认安装的ibm_db依赖的IBM CLI驱动版本和目标AS/400的DB2版本兼容，过旧的CLI驱动会在SSL握手、协议协商阶段超时无响应。同时检查本地出站防火墙规则，确认没有拦截python进程的出站TCP请求，可临时关闭本地出站防火墙测试连通性，若关闭后可正常连接，将python进程、IBM CLI驱动程序加入出站白名单即可。

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