Python应用通过SQLAlchemy连接本地SQL Server Express失败求助

你的SQLAlchemy连接URI存在多个格式错误，这是导致连接失败的核心原因，具体问题和修正方案如下：

1. 互斥身份验证参数冲突 #

你同时指定了SQL Server身份验证（dbuser:dbpasswd）和Windows身份验证（Trusted_Connection=yes），这两个参数互斥，只能保留其一。既然你通过SSMS用SQL Server身份验证成功，必须删除Trusted_Connection=yes。

2. URI格式语法错误 #

• 冗余前缀：去掉开头的@URI=，SQLAlchemy仅需mssql+pyodbc://开头的连接字符串。
• 参数分隔符错误：pyodbc连接参数需以?开头，参数间用&分隔，而非分号。
• 驱动名称空格处理：带空格的ODBC驱动名需要用大括号{}包裹，SQLAlchemy会自动处理格式兼容。
• 实例名与端口冗余：若明确指定端口1433，无需再写实例名\SQLEXPRESS；若保留实例名，可省略端口（需确保SQL Browser服务运行，自动解析实例端口），二者选其一即可。

修正后的URI示例 #

方案一：使用端口号（无需实例名） #

mssql+pyodbc://dbuser:dbpasswd@host:1433/mydb?driver={SQL Server Native Client 11.0}

方案二：使用实例名（无需端口，需SQL Browser服务运行） #

mssql+pyodbc://dbuser:dbpasswd@host\SQLEXPRESS/mydb?driver={SQL Server Native Client 11.0}

额外排查点 #

• 确认SQL Server Express实例的TCP/IP协议已启用：打开SQL Server配置管理器，找到SQLEXPRESS实例的网络配置，确保TCP/IP处于启用状态，且IP地址设置中正确绑定端口1433。
• 用纯pyodbc测试连接：跳过SQLAlchemy，直接用pyodbc验证基础连通性，缩小问题范围：

  import pyodbc
  conn = pyodbc.connect('DRIVER={SQL Server Native Client 11.0};SERVER=host\SQLEXPRESS;DATABASE=mydb;UID=dbuser;PWD=dbpasswd')
  

• 尝试更新ODBC驱动：若你的SQL Server版本较新，建议使用ODBC Driver 17 for SQL Server（兼容性更好），替换URI中的驱动名称即可。

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