直接创建pyodbc连接正常，使用SQLAlchemy URL连接失败问题排查

我之前也碰到过一模一样的问题，主要是两个核心原因导致的：

1. 密码中的特殊字符被URL解析器误拆分 #

你密码里的@符号在SQLAlchemy的URL格式里是用户信息和主机地址的分隔符，手动拼接URL时，这个@会被解析成结束密码的标记，导致实际传递给SQLAlchemy的密码是<YourStrong，后面的@Passw0rd被当成了主机地址的一部分，自然连接失败。

而直接用pyodbc.connect()的时候，你是把完整字符串作为连接参数传递，没有经过URL解析步骤，所以不会出现这个问题。

2. 缺少autocommit配置 #

你直接用pyodbc连接时显式设置了autocommit=True，但Alembic的SQLAlchemy URL里没有配置这个参数，某些SQL Server操作（比如创建数据库、DDL语句）需要自动提交才能生效，这也可能导致连接或操作失败。

解决办法 #

方法一：对密码中的特殊字符进行URL编码

把密码里的@替换成它的URL编码值%40，修改后的SQLAlchemy URL如下：

sqlalchemy.url = mssql+pyodbc://SA:<YourStrong%40Passw0rd>@localhost/test?driver=ODBC+Driver+17+for+SQL+Server&autocommit=true

注意末尾加上了&autocommit=true，和你直接pyodbc连接的配置保持一致。

方法二：用SQLAlchemy的URL构造器生成正确连接串

避免手动拼接URL的麻烦，你可以在Alembic的env.py里用sqlalchemy.engine.URL.create来构造连接，这样会自动处理特殊字符：

from sqlalchemy import create_engine
from sqlalchemy.engine import URL

url = URL.create(
    "mssql+pyodbc",
    username="SA",
    password="<YourStrong@Passw0rd>",
    host="localhost",
    database="test",
    query={"driver": "ODBC Driver 17 for SQL Server", "autocommit": "true"}
)
engine = create_engine(url)

然后在env.py里替换原来的engine初始化逻辑即可。

方法三：在pyodbc连接参数中单独指定密码

如果不想编码，也可以把密码放在connect_args里，在Alembic的env.py中修改：

from sqlalchemy import create_engine

engine = create_engine(
    "mssql+pyodbc://SA@localhost/test?driver=ODBC+Driver+17+for+SQL+Server",
    connect_args={"password": "<YourStrong@Passw0rd>", "autocommit": True}
)

这样绕开URL解析对密码的拆分，直接传递完整密码。

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