基于pyodbc从Linux连接Windows SQL Server的域身份认证问题

我来帮你搞定Linux下用pyodbc通过域账号连接Windows SQL Server的问题，结合你的场景（Python3、特定实例），给你一步步梳理解决方案：

先直接给你可用的代码示例，你只需要替换对应的参数即可：

import pyodbc

# 用原始字符串避免转义反斜杠，或者把\\改成\也可以
conn_str = r"""
DRIVER={ODBC Driver 18 for SQL Server};
SERVER=你的SQL服务器主机名\\目标实例名;
DATABASE=要连接的数据库名;
UID=你的域名称\\域用户名;
PWD=域用户的密码;
Encrypt=yes;
TrustServerCertificate=yes;
"""

try:
    conn = pyodbc.connect(conn_str)
    print("连接成功！可以开始执行SQL了")
    # 用完记得关闭连接
    conn.close()
except pyodbc.Error as e:
    print(f"连接失败，错误信息：{e}")

• 驱动名称要精准：你可以在Linux终端运行odbcinst -q -d命令，查看已安装的ODBC驱动名称，必须和连接字符串里的DRIVER值完全一致（比如可能是ODBC Driver 17 for SQL Server，大小写敏感）。
• 域账号格式：必须写成DOMAIN\用户名的格式，不要用user@domain.com这种UPN格式——Linux下的ODBC驱动对NTLM格式的支持更稳定。
• 实例指定方式：如果用主机名+实例名，要注意反斜杠的转义（要么用原始字符串r""，要么写双反斜杠\\）；也可以直接用IP地址,实例端口号的形式（比如192.168.1.100,1433），这种方式更不容易出解析问题。
• 加密参数：Encrypt=yes和TrustServerCertificate=yes是必须的——新版ODBC驱动默认要求加密连接，而Windows SQL Server的证书通常是自签的，加上这两个参数可以跳过证书验证，避免SSL连接错误。

Linux下用pyodbc实现Windows域认证，本质是ODBC驱动在后台调用NTLM认证协议（不需要额外配置Kerberos，更适合快速上手）。只要你的域账号密码正确，且SQL Server允许该域用户登录，驱动会自动完成认证流程，不需要你手动处理复杂的域交互细节。

如果还是连接失败，可以按以下方向排查：

• 登录失败错误：检查域账号密码是否正确，确认SQL Server的「安全性-登录名」里已经添加了该域用户，并且给了目标数据库的访问权限。
• 实例找不到：如果用主机名+实例名连不上，试试直接用IP+端口；另外要确保Windows防火墙开放了SQL Server的端口（默认1433，命名实例需要查对应端口），如果用SQL Browser服务，还要开放UDP 1434端口。
• 驱动问题：重新运行odbcinst -q -d确认驱动存在，或者卸载重装对应版本的ODBC驱动（微软官方的Linux版ODBC驱动即可）。

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