SQLAlchemy连接MSSQL在Windows本地无响应，Ubuntu Docker环境运行正常

阿华AIGC实验室

2026-4-14

看起来你遇到了一个挺闹心的跨环境问题——同样的代码在Ubuntu Docker里跑起来毫无压力，甚至不用导入pymssql都能正常工作，到了Windows本地（没Docker）就卡在engine.connect()这儿一动不动了。结合你的描述，我给你梳理几个排查方向和调试技巧：

先排查驱动与版本兼容性问题

核对Windows和Ubuntu两边的pymssql版本是否一致：不同版本的pymssql对Windows的依赖（比如FreeTDS组件）处理差异很大，你可以在两边分别执行pip show pymssql查看版本，试试把Windows上的pymssql升级/降级到和Ubuntu一致的版本。
同时检查SQLAlchemy的版本：不同版本的SQLAlchemy对mssql+pymssql连接的逻辑可能有调整，确保两边版本统一能避免不少坑。

调整连接字符串的写法试试

尝试用IP+端口的形式替代主机名+实例名：比如把server = "SRV-SQL\\xxx"改成server = "192.168.x.x,1433\\xxx"（换成你的SQL Server实际IP和端口），有时候Windows的NetBIOS解析会出问题，直接用IP能绕开这个坑。
换用pyodbc驱动连接：Windows上pyodbc是微软官方支持的SQL Server驱动，兼容性往往更好。把连接串改成下面这样试试（前提是你装了ODBC Driver 17 for SQL Server，Windows一般自带，没有的话可以直接安装微软官方驱动）：
```
engine = create_engine(f'mssql+pyodbc://{user}:{password}@{server}/{database}?driver=ODBC+Driver+17+for+SQL+Server')
```

实用的调试方法

开启SQLAlchemy的详细日志：在代码开头加上这段，能输出连接过程中的每一步操作，帮你定位到底卡在哪个阶段（是TCP连接、认证还是其他环节）：
```
import logging
logging.basicConfig()
logging.getLogger('sqlalchemy.engine').setLevel(logging.INFO)
```

单独测试原生pymssql连接：绕过SQLAlchemy，直接用pymssql写个简单的测试脚本，如果这个也卡住，说明问题出在pymssql与Windows的交互上，和SQLAlchemy无关；如果这个能正常跑，那就是SQLAlchemy的连接配置有问题：

import pymssql
conn = pymssql.connect(server='SRV-SQL\\xxx', user='xxx', password='xxx', database='xxx')
cursor = conn.cursor()
cursor.execute("SELECT ProductNumber, Matchcode FROM ASEArtikel WHERE ProductNumber = 'A000001' OR ProductNumber = 'A000003'")
print(cursor.fetchall())
conn.close()

检查Windows防火墙：临时关闭防火墙试试，或者在防火墙规则里给Python程序添加允许访问SQL Server端口（默认1433）的出站规则，有时候防火墙会悄悄拦截连接请求。
确认SQL Server的远程访问设置：虽然Docker能连，但Windows本地可能处于不同的网络环境，检查SQL Server是否允许本地IP访问，以及身份验证模式是否正确（比如你用的是SQL账号，确认SQL Server开启了混合身份验证）。