pyodbc连接Azure SQL DB报OperationalError登录超时问题

算力阿峰

2026-8-26

问题根因

你遇到的HYT00登录超时和即时触发的连接错误有本质区别：即时报错代表客户端根本没触达Azure SQL的网关节点，基本是驱动不匹配、地址拼写错误、端口完全不通导致；超时说明TCP层已经能摸到网关，阻塞出在防火墙拦截、TLS握手失败、认证校验不通过、链路中间设备拦截、连接字符串参数错误这几个环节。

排查解决步骤

按从易到难的顺序排查，不要上来就盲目改配置：

先做基础端口连通性校验
在运行代码的机器上执行端口测试，Windows下用PowerShell，Linux/macOS下用nc命令：
```
# Windows PowerShell
Test-NetConnection mydatabase.database.windows.net -Port 1433
```
```
# Linux/macOS
nc -zv mydatabase.database.windows.net 1433
```
如果测试返回端口不通，直接查本地出站防火墙、公司网络安全网关/代理的1433端口拦截规则——这是这类超时最高发的原因，企业网络通常会限制1433端口的出站访问，Azure SQL网关IP会动态调整，很容易被规则拦截。
核对Azure侧的访问控制配置
1. 到Azure SQL资源的网络设置页，把运行代码机器的公网IP加到防火墙允许列表里，注意如果本地网络开了IPv6优先，要把对应的IPv6地址也加上，不要只加IPv4地址
2. 如果用的是VNet私有端点连接，确认客户端机器和数据库所在VNet已经打通，关联的网络安全组放通了到SQL服务端点的1433端口流量
3. 测试阶段临时关闭「拒绝公共网络访问」开关，排除端点配置错误的干扰

修正连接字符串的写法
你当前的server参数手动拼接了tcp:前缀和端口，ODBC Driver 17会自动做协议和端口解析，手动拼接反而可能触发驱动的异常重试逻辑，拖慢认证流程触发超时。改成显式声明参数的写法：

cnxn = pyodbc.connect(
    driver='{ODBC Driver 17 for SQL Server}',
    server='mydatabase.database.windows.net',
    port=1433,
    database='MyDatabase',
    user='username',
    password='password',
    Encrypt='yes',
    TrustServerCertificate='no',
    Connection_Timeout=30
)

排查认证环节问题
1. 确认你用的是SQL认证的账号密码，不是Azure门户的登录账号——如果数据库开了仅Azure AD认证，SQL认证账号默认是禁用的，会卡在认证校验阶段超时
2. 如果账号开启了MFA多因素认证，不能直接用明文用户名密码的连接方式，要改用AD交互式认证或者服务主体认证
3. 到Azure监控面板看数据库的资源负载，如果DTU/VCore打满，登录请求会排队等待处理，超过驱动的超时阈值就会抛错，这种情况临时扩容就能解决
排查本地环境兼容问题
1. 把本地安装的ODBC Driver 17升级到最新正式版，旧版本驱动和TLS 1.2/1.3的协商逻辑有兼容bug，Azure SQL强制要求TLS 1.2以上加密连接，旧驱动会卡在TLS握手阶段超时
2. 临时退出本地的杀毒软件、终端安全管理软件做测试，这类软件经常会做SSL流量中间人检测，打断ODBC和SQL网关的TLS握手流程
3. 如果系统配置了全局HTTP代理，要给SQL域名配置代理绕过规则，ODBC驱动不支持通过HTTP代理透传SQL流量，会卡在代理握手阶段超时

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