MacOS下mssql-django连SQL Server报错，Windows正常的原因

MacOS系统未安装ODBC Driver 17 for SQL Server驱动程序，这是报错的核心原因。Windows系统中该驱动通常默认存在或易于获取，但MacOS需手动部署对应的ODBC驱动环境。

解决步骤 #

1. 安装Homebrew（未安装时执行）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装unixODBC基础组件：

   brew install unixodbc
   

3. 添加微软软件源并安装ODBC驱动17：

   brew tap microsoft/mssql-release
   ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools
   

4. 验证驱动状态：
   运行odbcinst -j，查看输出的ODBC Drivers区域，确认存在ODBC Driver 17 for SQL Server条目且对应文件路径有效。

完成以上操作后，重新执行python3 manage.py runserver即可正常连接数据库，原Django配置无需修改。

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