使用pyodbc连接Azure SQL遇HY000瞬态错误求助

你碰到的是Azure SQL非常常见的瞬态连接故障，这类错误大多由网络波动、云服务临时抖动引发，不用太焦虑，试试下面这些针对性方案：

1. 给连接逻辑加上自动重试机制 #

瞬态错误的核心应对思路就是重试——Azure官方也明确推荐对这类错误进行3-5次重试。你可以用tenacity库快速实现，或者自己写个简单的循环：

import pyodbc
import time

def get_connection_with_retry(max_retries=3):
    driver = '{ODBC Driver 13 for SQL Server}'  # 后续建议升级到18版本
    server = '你的服务器地址'
    username = '你的用户名'
    database = '你的数据库名'
    
    for attempt in range(max_retries):
        try:
            cnxn = pyodbc.connect(
                driver=driver,
                server=server,
                user=username,
                database=database,
                Trusted_Connection='yes',
                autocommit=True
            )
            print(f"第{attempt+1}次尝试连接成功")
            return cnxn
        except pyodbc.Error as e:
            if attempt < max_retries -1:
                wait_time = 2 ** attempt  # 指数退避等待，避免频繁请求加剧问题
                print(f"连接失败，{wait_time}秒后重试... 错误信息：{e}")
                time.sleep(wait_time)
            else:
                raise e

# 使用示例
try:
    cnxn = get_connection_with_retry()
except Exception as e:
    print(f"多次重试后仍无法连接：{e}")

2. 升级ODBC驱动版本 #

你当前使用的ODBC Driver 13版本偏旧，对Azure SQL的AD身份验证兼容性不如新版。建议直接升级到ODBC Driver 18 for SQL Server，新版本修复了大量旧版本的身份验证、网络连接问题，还支持更安全的加密配置。

升级后修改连接字符串的驱动名称，同时补上Azure强制要求的加密参数：

cnxn = pyodbc.connect(
    driver='{ODBC Driver 18 for SQL Server}',
    server=server,
    user=username,
    database=database,
    Trusted_Connection='yes',
    autocommit=True,
    Encrypt='yes',  # Azure SQL强制要求加密连接
    TrustServerCertificate='no'  # Azure使用正规CA证书，无需信任自签名证书
)

3. 检查网络与环境配置 #

• 确认你的网络没有防火墙、代理阻止了1433端口（Azure SQL的默认通信端口）
• 如果使用Azure AD身份验证，确保本地的Microsoft Online Services Sign-In Assistant是最新版本（不过升级ODBC驱动通常会顺带解决这个组件的兼容问题）
• 登录Azure门户检查你的SQL数据库是否处于正常运行状态，有没有临时的服务告警

错误原因补充 #

你遇到的x80048849错误，本质是AD身份验证过程中出现了临时网络异常——比如身份验证请求传输丢包、Azure AD服务短暂不可用。这类问题不会持续存在，重试或者升级驱动后基本都能解决。

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