使用SQLAlchemy+pyodbc连接MSSQL出现28000登录失败及参数报错问题

编码后报28000登录失败 #

可能成因 #

• SQLAlchemy 1.4版本对odbc_connect查询参数的解析逻辑存在重复URL解码问题。经quote_plus编码的连接串，会被URL解析层第一次解码得到包含pass+word10的正确值；若多执行一次解码，字符串中原本的+会被识别为URL转义的空格，导致实际传递的密码变为pass word10，与真实凭据不匹配触发登录失败。
• 配置文件中读取的密码存在不可见隐藏字符（如换行、首尾空格）。因mssql-tools测试时直接使用odbc.ini中存储的DSN凭据，未读取配置文件内的密码，无法感知该问题。
• 高版本SQLAlchemy的pyodbc方言默认追加了额外连接参数（如强制加密、认证模式调整），与目标MSSQL服务器配置不兼容，但服务器仍返回身份验证类错误码。

不编码传连接串报08001找不到SERVER/DSN #

可能成因 #

• SQLAlchemy的create_engine要求入参为符合RFC规范的URL字符串，未编码的原始ODBC连接串包含;、=等URL特殊字符，会被URL解析器识别为查询参数分隔符，将完整ODBC连接串拆分为多个独立的顶层查询参数。最终odbc_connect参数仅拿到DRIVER开头的片段，SERVER、UID、PWD等核心参数全部丢失，pyodbc收到的连接串既无SERVER也无DSN，触发该错误。

排查与调试方法 #

• 跳过SQLAlchemy层，直接用pyodbc原生连接测试：
  执行pyodbc.connect("DRIVER={ODBC Driver 17 for SQL Server};SERVER=172.12.3.45;DATABASE=my_db;UID=myuser;PWD=pass+word10")，若连接成功，说明问题完全出在SQLAlchemy的URL解析环节；若连接失败，直接排查pyodbc本身的连接配置。
• 核验实际传递给pyodbc的最终连接串：
  创建engine后触发原生连接，开启pyodbc日志输出，确认最终传入的密码、SERVER参数是否与预期一致，排除参数被错误修改的情况。
• 调整编码方式：将urllib.parse.quote_plus替换为urllib.parse.quote（设置safe=''），该方法会把空格编码为%20而非+，避免重复解码时加号被误转为空格的问题。
• 绕开URL解析逻辑，使用creator参数传入原生连接：

  import pyodbc
  def init_conn():
      conn_str = (
          "DRIVER={ODBC Driver 17 for SQL Server};"
          f"SERVER={CONF['db']['db_ip']};"
          f"DATABASE={CONF['db']['dest_db']};"
          f"UID={CONF['db']['username']};"
          f"PWD={CONF['db']['password']}"
      )
      return pyodbc.connect(conn_str)
  engine = create_engine("mssql+pyodbc://", creator=init_conn)
  

  该方式完全不经过SQLAlchemy的URL编码、解析流程，从根源上避免连接串被拆分、错误解码的问题。
• 改用已配置的DSN连接：直接把DSN名作为host部分拼接URL，不需要手动编码完整ODBC连接串，示例格式为mssql+pyodbc://myuser:pass%2Bword10@MyMSSQLServer/my_db。
• 升级SQLAlchemy到1.4分支的最新小版本，修复历史版本中pyodbc方言的URL解析bug。

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