1. 为什么 Python 连 SQL Server 2005 会“无响应”或报错SQL Server 2005 是个老版本默认协议、TDS 版本、认证方式都和现在的新版不一样。Python 这边常用的两个库 pymssql 和 pyodbc底层走的通道完全不同pymssql 直接基于 FreeTDS 实现pyodbc 走 ODBC 驱动管理器再对接驱动。任何一层版本对不上表现就是“卡住不返回”或者抛一个看不懂的驱动错误。典型症状有三类。第一类是工作台无反应脚本跑起来不报错也不打印光标一直闪等几分钟才超时。这通常是 TDS 协商卡住或者端口被防火墙静默丢包。第二类是驱动加载失败比如Cant open lib SQL SERVER : file not found这是 ODBC 驱动名写错或驱动没装。第三类是登录失败报Login failed for user多半是认证模式或账号权限问题。这篇面向的是需要维护老系统的 Python 开发者尤其是半路接手 SQL Server 2005 项目、在 Windows 和 Linux 上都要跑脚本的人。我会给出 pymssql 和 pyodbc 两套可复制的连接骨架再配一份从驱动到网络的排查清单。核心结论先放这里连 SQL Server 2005pymssql 加tds_version7.0往往能解决大部分“无响应”pyodbc 则要确保驱动名和 FreeTDS 配置一致。2. 动手前的前置准备驱动、端口与账号确认在写连接代码之前先把三件事确认清楚能省掉后面一大半排查时间。第一确认 SQL Server 2005 实例的 TCP/IP 协议是否启用。SQL Server 2005 默认可能只开命名管道没开 TCP。打开 SQL Server 配置管理器展开“SQL Server 2005 网络配置”看实例的 TCP/IP 是否为“已启用”。如果没启用客户端怎么连都连不上。启用后记下 TCP 端口默认实例是 1433命名实例是动态端口建议在 TCP/IP 属性里把“TCP 动态端口”清空手动指定 1433。第二确认认证模式。SQL Server 2005 支持 Windows 认证和 SQL Server 认证混用。如果只用 Windows 认证Python 在 Linux 上基本没法直接连必须让 DBA 开启混合模式并建一个 SQL 账号。检查方法是在 SSMS 里右键实例属性看“安全性”页的服务器身份验证模式。第三确认网络可达。在跑 Python 的机器上用 telnet 测端口telnet 192.168.1.100 1433如果连不上先解决网络和防火墙别急着调代码。Windows 防火墙、云主机安全组都可能拦 1433。关于 TaoToken如果你在调试过程中需要快速验证模型生成的连接代码或排查思路可以用它的模型对话能力做辅助。它的 API 入口是 https://taotoken.net/api 模型对话 deep link 是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chat 。不过连接数据库这种活最终还是要在本地环境实测。3. pymssql 连接骨架tds_version 是关键pymssql 是我在 Linux 上连 SQL Server 2005 的首选因为它不依赖 ODBC 驱动管理器少一层配置就少一堆坑。安装直接用 pippip install pymssql连接代码骨架如下注意tds_version这个参数# -*- coding: utf-8 -*- import pymssql conn pymssql.connect( host192.168.1.100, port1433, usersa, passwordYourPassword, databaseYourDB, charsetcp936, tds_version7.0 ) cursor conn.cursor() cursor.execute(SELECT TOP 5 name FROM sys.databases) for row in cursor.fetchall(): print(row) cursor.close() conn.close()这里几个参数值得展开说。tds_version7.0是重点SQL Server 2005 对应 TDS 7.0pymssql 新版默认可能用更高的 TDS 版本去协商老实例不认就卡住。我试过不加这个参数脚本直接挂起不返回加上就通了。charsetcp936是为了兼容中文SQL Server 2005 时代很多库用 GBK 编码用 utf8 可能读出乱码。如果你的实例是命名实例比如MSSQLSERVER2005host 要写成192.168.1.100\\MSSQLSERVER2005这种形式或者直接用host192.168.1.100:1433指定端口绕过实例名解析。4. pyodbc 连接骨架驱动名与 FreeTDS 配置pyodbc 在 Windows 上很好用因为系统自带 SQL Server ODBC 驱动。连接骨架# -*- coding: utf-8 -*- import pyodbc conn pyodbc.connect( DRIVER{SQL Server}; SERVER192.168.1.100; UIDsa; PWDYourPassword; DATABASEYourDB ) cursor conn.cursor() cursor.execute(SELECT TOP 5 name FROM sys.databases) rows cursor.fetchall() for row in rows: print(row) cursor.close() conn.close()Windows 上DRIVER{SQL Server}是系统自带的老驱动兼容 SQL Server 2005。如果报Cant open lib SQL SERVER说明驱动名不对用下面命令列出可用驱动import pyodbc print(pyodbc.drivers())Linux 上就麻烦多了需要装 FreeTDS 和 unixODBC然后在/etc/odbcinst.ini里注册驱动[FreeTDS] DescriptionFreeTDS Driver Driver/usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so Setup/usr/lib/x86_64-linux-gnu/odbc/libtdsS.so再在/etc/odbc.ini里配数据源[SQL2005] DriverFreeTDS Server192.168.1.100 Port1433 TDS_Version7.0 DatabaseYourDB连接时用 DSNconn pyodbc.connect(DSNSQL2005;UIDsa;PWDYourPassword)Linux 上 pyodbc 报Cant open lib十有八九是odbcinst.ini里的路径写错或者libtdsodbc.so根本没装。用odbcinst -j看配置文件位置用ldd检查 so 文件依赖是否齐全。5. 验证请求与成功结果配置写完后别急着跑完整业务脚本先用最小验证。pymssql 的验证import pymssql try: conn pymssql.connect(host192.168.1.100, port1433, usersa, passwordYourPassword, databasemaster, tds_version7.0) print(连接成功) cur conn.cursor() cur.execute(SELECT VERSION) print(cur.fetchone()) conn.close() except Exception as e: print(失败:, e)成功的话会打印类似Microsoft SQL Server 2005 - 9.00.xxxx。如果卡在这里不返回就是 TDS 协商或网络问题。pyodbc 的验证类似重点看pyodbc.connect是否抛异常。成功连接后SELECT VERSION能返回版本号说明驱动、认证、网络三层都通了。验证顺序建议先 telnet 端口再跑最小连接脚本最后跑业务查询。每一步都单独确认别混在一起调。6. 本篇常见错误排查清单下面这张表覆盖了我踩过的大部分坑报错/现象可能原因处理方式脚本无响应不报错TDS 版本不匹配pymssql 加tds_version7.0Cant open lib SQL SERVERODBC 驱动名错或未装用pyodbc.drivers()查驱动名Login failed for user认证模式或密码错确认混合模式重置 SQL 账号密码连接超时端口不通或防火墙telnet 测 1433检查安全组中文乱码字符集不匹配pymssql 用charsetcp936命名实例连不上动态端口未固定手动指定 1433 端口FreeTDS 报协议错TDS_Version 未设odbc.ini 加TDS_Version7.0排查时按“网络→驱动→认证→TDS”的顺序走别跳步。我见过太多人一上来就改代码结果发现是防火墙没开端口。如果你在排查过程中需要查 FreeTDS 或 pyodbc 的配置文档或者想让模型帮你分析报错日志可以用 TaoToken 的接入文档和 API Keys 页面。接入文档 deep link 是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys 。把报错原文贴进去让它帮你定位比盲目搜教程快。7. 长期维护老项目的工具选择SQL Server 2005 这类老系统维护周期可能很长。如果你经常要写连接脚本、调 SQL、排查驱动问题可以考虑用 Coding Plan 来管理你的调试代码片段和排查记录。它的入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan 。把常用的连接骨架、排查命令存成模板下次遇到新实例直接套用比每次重新搜教程省事。最后给一个实用建议把 pymssql 和 pyodbc 两套连接都封装成函数参数从环境变量读别硬编码密码。老项目的密码经常改硬编码会让你改到崩溃。连接成功后记得cursor.close()和conn.close()SQL Server 2005 的连接数限制比较紧不关连接容易把实例拖垮。