使用SQLAlchemy连接本地SQL Express服务器报错如何解决

你遇到的IM002报错由两个核心问题直接导致：

• 连接字符串中指定的ODBC Driver 13 for SQL Server驱动不存在于本机环境，ODBC驱动管理器找不到对应驱动完成连接初始化
• Python普通字符串中\是转义符，直接写DESKTOP-A1BUCDR\SQLEXPRESS时，\S会被解析为非法转义字符，最终传给驱动的实例名完全错误，直接触发连接失败

按以下步骤逐一排查调整即可：

1. 确认本机实际安装的ODBC驱动版本
   打开Windows系统的「ODBC 数据源(64位)管理器」，切换到「驱动程序」标签，找到名称包含ODBC Driver * for SQL Server的条目，记录准确的版本号（常见为17、18版本；如果列表中没有对应版本的驱动，先下载安装匹配Python位数的安装包，64位Python必须装64位驱动）。
2. 修正连接字符串的转义问题
   给连接字符串加r前缀标记为Python原始字符串，避免反斜杠被错误转义；如果使用18及以上版本的ODBC驱动，必须额外添加TrustServerCertificate=yes参数跳过本地实例的证书校验。
3. （可选排查项）如果调整后仍连不上，打开SQL Server配置管理器，确认SQLEXPRESS实例的TCP/IP协议已启用，同时SQL Server Browser服务处于运行状态。

修正后的可运行代码参考（以安装了ODBC Driver 17为例）：

import sqlalchemy as sal
import pandas as pd

# 原始字符串避免转义问题，驱动名替换为你本机实际查到的版本
conn_config = (
    r"mssql+pyodbc://@DESKTOP-A1BUCDR\SQLEXPRESS/Northwind"
    r"?driver=ODBC+Driver+17+for+SQL+Server"
    # 若使用18版本驱动，注释上一行的driver参数，启用下面两行配置
    # r"?driver=ODBC+Driver+18+for+SQL+Server"
    # r"&TrustServerCertificate=yes"
)
engine = sal.create_engine(conn_config)
df = pd.read_sql_query("SELECT * FROM Orders", engine)

如果反复排查驱动配置仍有问题，可以直接在ODBC管理器中手动创建一个指向该SQLEXPRESS实例、Northwind库的系统DSN并测试连通，之后连接字符串可以简化为mssql+pyodbc://@/Northwind?dsn=你自定义的DSN名称，完全绕开驱动名、实例名配置错误的问题。

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