Linux环境下Python通过AD域账号连接SQL Server失败求助

场景背景 #

• 已获取<Domain/Username>权限访问关联Active Directory的Windows SQL Server
• Windows工作站上，pyodbc/pymssql脚本通过Trusted_Connection=yes自动认证可正常获取数据
• 迁移至Linux Kubernetes环境后，手动指定AD账号密码连接均失败

出错代码及错误信息 #

pyodbc脚本及错误 #

import pyodbc
conn = pyodbc.connect("DRIVER={ODBC Driver 17 for SQL Server};;SERVER=<server>\<instance>,<port>;DATABASE=<database>;Trusted_Connection=yes;UID=<domain>\<username>;PWD=<password>;Integrated_Security=SSPI")

错误：pyodbc.OperationalError: ('HYT00', '[HYT00] [Microsoft][ODBC Driver 17 for SQL Server]Login timeout expired (0) (SQLDriverConnect)')

pymssql脚本及错误 #

import pymssql
conn = pymssql.connect(host='<server>', server='<instance>', port='<port>', database='<database>', user='<domain\\username>', password='<password>', tds_version='7.0') 

错误：pymssql.exceptions.OperationalError: (20009, b'DB-Lib error message 20009, severity 9:\nUnable to connect: Adaptive Server is unavailable or does not exist (<server>)\nNet-Lib error during Connection timed out (110)\n')

问题分析与解决方案 #

1. 代码本身的错误 #

pyodbc连接字符串问题

• 存在多余分号（;;），导致参数解析异常
• Trusted_Connection=yes与Integrated_Security=SSPI重复，且Linux环境不支持SSPI，需改用AD密码认证方式
• 反斜杠未转义，需用原始字符串（r""）或双反斜杠（\\）避免转义错误

修正后的pyodbc代码：

import pyodbc
# 用原始字符串避免转义，指定AD密码认证方式
conn_str = r"""
DRIVER={ODBC Driver 18 for SQL Server};
SERVER=<server>\<instance>,<port>;
DATABASE=<database>;
UID=<domain>\<username>;
PWD=<password>;
Authentication=ActiveDirectoryPassword;
Encrypt=yes;
TrustServerCertificate=yes;
"""
conn = pyodbc.connect(conn_str)

说明：Encrypt=yes是当前SQL Server的默认要求，TrustServerCertificate=yes用于自签证书场景，可根据实际环境调整。

pymssql参数问题

• host与server参数重复，需合并为host="<server>\<instance>,<port>"
• tds_version='7.0'版本过旧（对应SQL Server 2000），需根据SQL Server版本调整为7.3（SQL Server 2012+）或7.4（SQL Server 2016+）

修正后的pymssql代码：

import pymssql
conn = pymssql.connect(
    host=r'<server>\<instance>,<port>',
    database='<database>',
    user=r'<domain>\<username>',
    password='<password>',
    tds_version='7.4',
    encrypt='yes'
)

2. 遗漏的环境配置步骤 #

容器依赖安装

• pyodbc环境：需在K8s镜像中安装unixODBC驱动和微软SQL Server ODBC驱动（如msodbcsql18），以Debian/Ubuntu为例：

  apt-get update && apt-get install -y unixodbc unixodbc-dev
  curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
  curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list
  apt-get update && ACCEPT_EULA=Y apt-get install -y msodbcsql18
  

• pymssql环境：需安装FreeTDS依赖，以Debian/Ubuntu为例：

  apt-get update && apt-get install -y freetds-dev freetds-bin python3-dev
  

网络连通性验证

• 在K8s Pod内执行nc -zv <server> <port>，确认SQL Server端口未被防火墙、安全组或K8s网络策略拦截
• 若使用SQL Server命名实例，需确保SQL Browser服务正常运行，且UDP 1434端口开放（或直接指定实例对应的TCP端口）

AD账号权限验证

• 确认AD账号密码未过期，且该账号被授予从Linux客户端访问SQL Server的权限
• 检查SQL Server登录映射，确保AD账号已关联对应的数据库用户及权限

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