PyInstaller打包SQL连接EXE分发后遇pyodbc数据源未找到错误

原因分析 #

• 目标机器未安装指定的ODBC驱动：你代码里指定的SQL Server Native Client 11.0是微软提供的系统级ODBC驱动，这类驱动不会被PyInstaller打包进exe文件，必须在运行exe的机器上单独安装。很多新Windows系统默认没有预装这个老版本驱动。
• 驱动位数与exe位数不匹配：如果你的exe是32位（比如用32位Python环境打包），但目标机器只安装了64位的对应驱动，或者反过来，就会出现驱动找不到的错误。
• 驱动名称过时：SQL Server Native Client属于较旧的驱动系列，微软目前推荐使用ODBC Driver for SQL Server（如17、18版本），这类新驱动兼容性更强，新系统适配性更好。

解决方案 #

1. 更换为通用的ODBC驱动（优先推荐） #

修改代码中的连接字符串，将驱动替换为更通用、维护更活跃的版本，比如ODBC Driver 17 for SQL Server，该驱动支持绝大多数Windows系统，且微软持续更新：

from sqlalchemy.engine import URL
from sqlalchemy import create_engine

# 替换驱动名称
connection_string = 'DRIVER={ODBC Driver 17 for SQL Server};SERVER=server_name;DATABASE=db_name;UID=username;PWD=password'

connection_url = URL.create("mssql+pyodbc", query={"odbc_connect": connection_string})
engine = create_engine(connection_url)
conn = engine.connect()

修改后重新打包exe，多数新系统可能已经预装该驱动，用户无需额外安装即可运行。

2. 让目标用户安装对应驱动 #

如果坚持使用原驱动SQL Server Native Client 11.0，需要让用户下载并安装对应位数的驱动：

• 确保驱动位数与exe位数一致：若exe是64位，安装64位驱动；exe是32位则安装32位驱动。

3. 匹配exe与驱动的位数 #

• 检查当前Python环境位数：运行import sys; print(sys.maxsize > 2**32)，返回True表示64位，False表示32位。
• 用对应位数的Python打包exe，确保目标机器安装的驱动位数与exe一致。

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