Azure Function中无法导入pyodbc但普通Python文件可正常导入（使用同一虚拟环境）

我之前在M1 Mac上也碰到过几乎一模一样的问题，这个_SQLAllocHandle符号找不到的错误，本质是pyodbc没有正确关联到系统的ODBC驱动库，再加上Azure Functions Worker的环境隔离和M1架构的兼容性问题在捣乱。下面是我亲测有效的解决步骤：

1. 先搞定M1架构的适配问题 #

M1的ARM64架构和很多预编译的x86_64包不兼容，这是核心矛盾：

• 首先检查你的ODBC驱动：一定要装ARM64版本的（比如微软的SQL Server ODBC驱动，别不小心装了x86的）
• 别用pip的预编译包，手动从源码编译pyodbc：

  # 先卸载现有版本
  pip uninstall -y pyodbc
  # 设置编译标志，指定你的ODBC库路径（默认一般在/usr/local/lib，根据实际安装路径调整）
  export LDFLAGS="-L/usr/local/lib"
  export CPPFLAGS="-I/usr/local/include"
  # 从源码编译安装
  pip install pyodbc --no-binary pyodbc
  

• 如果实在不想折腾ARM64，也可以用Rosetta终端：右键终端图标选择「使用Rosetta打开」，然后重新创建虚拟环境、安装pyodbc，整个环境用x86_64兼容模式运行。

2. 调整Azure Functions Worker的环境配置 #

Azure Functions Core Tools在M1上会有环境隔离和权限问题（比如你看到的/dev/shm权限错误），需要做这些配置：

• 确保函数项目关联到你的虚拟环境：在项目根目录的local.settings.json里添加PYTHONPATH，指向虚拟环境的site-packages目录：

  {
    "IsEncrypted": false,
    "Values": {
      "FUNCTIONS_WORKER_RUNTIME": "python",
      "AzureWebJobsStorage": "UseDevelopmentStorage=true"
    },
    "PYTHONPATH": "./.venv/lib/python3.9/site-packages"
  }
  

• 解决/dev/shm的权限问题：启动Functions前设置一个临时目录替代共享内存目录：

  # 创建临时目录
  mkdir -p /tmp/azure-functions-shm
  # 设置环境变量
  export AZURE_FUNCTIONS_SHARED_MEMORY_DIR="/tmp/azure-functions-shm"
  

• 另外检查你的Core Tools版本：用Homebrew装的话，确保是ARM64版本，别装成x86_64的了。

3. 修复Python 3.7.4的兼容问题 #

Python 3.7.4本身对M1的ARM64支持很差，建议：

• 用pyenv安装Python 3.7.13及以上版本（这几个版本才正式支持ARM64），别用系统自带的3.7.4
• 同样按照步骤1的方法，从源码编译安装pyodbc，确保和Python版本、架构匹配。

最后验证 #

做完上面的步骤后，先在虚拟环境里验证：

python -c "import pyodbc; print(pyodbc.drivers())"

如果能正常输出驱动列表，再启动Azure Functions：

func start

测试导入pyodbc的函数，应该就能正常运行了。

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