M1 Mac虚拟环境中pyodbc连接SQL Server登录失败求助

问题现象 #

全局Python环境可正常连接SQL Server，但虚拟环境中出现登录失败错误：

Error connecting to the database: (pyodbc.InterfaceError) ('28000', "[28000] [Microsoft][ODBC Driver 18 for SQL Server][SQL Server]Login failed for user 'userx'. (18456) (SQLDriverConnect)")

环境详情 #

• 全局环境：
  • Python 3.11
  • pip全局安装pyodbc、SQLAlchemy
  • 连接成功
• 虚拟环境：
  • Python 3.11（与全局版本一致）
  • pip安装pyodbc、SQLAlchemy
  • 连接失败

已确认的调试信息 #

• 两个环境均检测到相同的ODBC驱动（包含ODBC Driver 18 for SQL Server）
• 环境变量已正确加载，凭据验证无误
• 连接字符串格式与全局环境完全一致

测试代码 #

import pyodbc
import os
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()

# 读取连接参数
SQL_USER = os.getenv("SQL_USER")
SQL_PASS = os.getenv("SQL_PASS")
SQL_SERVER = os.getenv("SQL_SERVER")
SQL_PORT = os.getenv("SQL_PORT")
SQL_DATABASE = os.getenv("SQL_DATABASE")

# 构建连接字符串（注意：原代码中使用的;;分隔符错误，改为标准的;）
connection_string = (
    f"DRIVER={{{ODBC Driver 18 for SQL Server}}};"
    f"SERVER={SQL_SERVER},{SQL_PORT};"
    f"DATABASE={SQL_DATABASE};"
    f"UID={SQL_USER};"
    f"PWD={SQL_PASS};"
    f"TDS_Version=8.0;"
)

# 测试连接
try:
    conn = pyodbc.connect(connection_string)
    print("Connection successful!")
    conn.close()
except Exception as e:
    print(f"Error connecting to the database: {e}")

已执行的排查步骤 #

1. 验证用户名、密码完全正确
2. 确认两个环境中环境变量加载正常

补充信息 #

• 相同凭据和连接字符串在全局环境中可正常使用
• SQL Server日志仅显示通用登录失败，无额外细节

可能原因及解决方案 #

1. M1芯片架构兼容性问题 #

M1 Mac为ARM架构，若全局Python是通过Rosetta 2模拟的x86_64版本，而虚拟环境使用原生ARM版本，会导致pyodbc与ODBC驱动架构不匹配，引发连接异常。

• 解决方法：
  • 检查全局Python架构：执行python3 -c "import platform; print(platform.machine())"，若输出x86_64则为Rosetta模拟版本。
  • 用Rosetta创建虚拟环境：右键终端选择「使用Rosetta打开」，再执行python3 -m venv venv创建虚拟环境，激活后重新安装依赖。

2. 虚拟环境无法识别ODBC驱动路径 #

虽检测到驱动存在，但虚拟环境可能无法读取驱动的系统配置路径，导致连接失败。

• 解决方法：
  • 在连接字符串中指定驱动完整路径（M1 Mac上ODBC Driver 18的典型路径为/Library/ODBC/libmsodbcsql.18.dylib）：

    DRIVER_PATH = "/Library/ODBC/libmsodbcsql.18.dylib"
    connection_string = (
        f"DRIVER={{{DRIVER_PATH}}};"
        f"SERVER={SQL_SERVER},{SQL_PORT};"
        f"DATABASE={SQL_DATABASE};"
        f"UID={SQL_USER};"
        f"PWD={SQL_PASS};"
        f"TDS_Version=8.0;"
    )
    

3. 虚拟环境中pyodbc安装不完整 #

虚拟环境安装pyodbc时，若依赖缺失可能导致编译不完整，引发功能异常。

• 解决方法：
  • 卸载虚拟环境中的pyodbc：pip uninstall pyodbc -y
  • 指定ODBC依赖路径重新安装：

    pip install pyodbc --global-option=build_ext --global-option="-I/Library/ODBC/include" --global-option="-L/Library/ODBC/lib"
    

4. 环境变量覆盖问题 #

load_dotenv()加载的.env参数可能被虚拟环境中的系统环境变量覆盖，导致凭据错误。

• 解决方法：
  • 在代码中打印所有连接参数，确认是否与全局环境一致：

    print(f"SQL_USER: {SQL_USER}")
    print(f"SQL_PASS: {SQL_PASS}")
    print(f"SQL_SERVER: {SQL_SERVER}")
    

  • 测试时可临时在连接字符串中硬编码凭据（仅用于排查），确认是否为变量加载问题。

5. SQL Server登录验证策略拦截 #

全局环境的连接请求可能通过了SQL Server的验证策略，但虚拟环境的请求被拦截（如IP限制、登录次数限制等）。

• 解决方法：
  • 查看SQL Server登录日志的18456错误子状态（子状态1=密码错误，子状态8=密码正确但数据库不可访问等），定位具体原因。
  • 确认SQL Server允许该用户从当前机器IP登录。

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