Mac M3芯片下Pyenv管理Python时pymssql报_bcp_batch符号缺失错误

问题原因 #

M3芯片为arm64架构，预编译的pymssql包未适配该架构，且依赖的FreeTDS库可能未正确安装或路径未被识别。

方案一：重新编译适配arm64的pymssql #

• 卸载现有pymssql

pip uninstall -y pymssql

• 安装arm64版本的FreeTDS依赖

brew install freetds

• 确保安装Xcode命令行工具（编译必备）

xcode-select --install

• 设置环境变量，让pip找到FreeTDS的头文件和库文件

export LDFLAGS="-L$(brew --prefix freetds)/lib"
export CFLAGS="-I$(brew --prefix freetds)/include"

• 针对当前pyenv的Python版本，从源码编译安装pymssql

pip install pymssql --no-binary :all:

• 验证Python架构（确保是arm64）
  运行以下命令，输出应为arm64：

python -c "import platform; print(platform.machine())"

如果输出是x86_64，说明当前Python是通过Rosetta运行的，需重新编译arm64版本的Python：

PYTHON_CONFIGURE_OPTS="--enable-universalsdk=/ --with-universal-archs=arm64" pyenv install 3.12.4

方案二：改用pyodbc替代pymssql（更稳定的适配方案） #

pymssql维护活跃度较低，pyodbc对M系列芯片支持更完善：

• 卸载pymssql

pip uninstall -y pymssql

• 安装pyodbc和微软ODBC驱动

brew install microsoft-mssql-release
brew install msodbcsql18 mssql-tools18
pip install pyodbc

• 修改脚本中的连接字符串
  将原连接字符串替换为：

source_engine = create_engine(f"mssql+pyodbc://{v_user}:{v_password}@{v_server}:1433/{v_database}?driver=ODBC+Driver+18+for+SQL+Server&TrustServerCertificate=yes")

（添加TrustServerCertificate=yes可避免证书验证问题，根据实际情况调整）

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