Azure Function部署后出现sqlalchemy模块找不到错误求助

一、确认部署包结构与依赖路径 #

Azure Functions Python运行时默认从__app__/.python_packages/lib/site-packages加载依赖，需确保：

• 本地安装依赖时明确指定目标路径，执行命令：

  pip install -r requirements.txt --target __app__/.python_packages/lib/site-packages
  

• 打包时必须包含__app__目录下所有内容，包括.python_packages文件夹，不能仅打包代码文件。
• 解压部署包验证：确认__app__/.python_packages/lib/site-packages/sqlalchemy目录存在且文件完整。

二、验证Python版本匹配 #

本地用Python 3.11开发，必须确保Azure Function App运行时版本一致：

1. 进入Azure Portal的Function App页面
2. 左侧菜单选「配置」→「常规设置」
3. 确认「Python版本」为3.11，「运行时堆栈」为Python

• 避免本地与云端Python版本差异导致依赖二进制文件不兼容。

三、调整环境变量配置 #

添加/修改以下环境变量，确保运行时能正确识别依赖路径：

• PYTHONPATH: Windows环境设为D:\home\site\wwwroot\__app__;D:\home\site\wwwroot\__app__\.python_packages\lib\site-packages；Linux环境设为/home/site/wwwroot/__app__:/home/site/wwwroot/__app__/.python_packages/lib/site-packages
• SCM_DO_BUILD_DURING_DEPLOYMENT: 设置为true（仅Linux SKU有效，让Oryx部署时自动构建依赖）
• 备注：Windows SKU不支持Oryx自动构建，必须手动预安装依赖到部署包。

四、修正手动CLI部署问题 #

若CLI部署时遇SKU不支持提示，是因为Python 3.11仅支持Premium (EP1/EP2/EP3) 或 Dedicated (App Service Plan) SKU，Consumption SKU暂不支持（截至2024年）：

• 重新创建Function App并选择支持的SKU，再执行部署命令：

  func azure functionapp publish <你的函数应用名称> --python --no-build
  

  加--no-build参数避免云端重新构建，直接使用本地预打包的依赖。

五、排查详细运行时日志 #

除ModuleNotFoundError外，查看更完整的错误信息：

• 进入Azure Portal的Function App→「监控」→「日志」，开启「详细错误日志」
• 检查是否存在子模块缺失、权限问题，或sqlalchemy版本不兼容（确保requirements.txt中sqlalchemy版本≥1.4.46，该版本开始支持Python 3.11）

六、测试最小化复现场景 #

创建极简函数仅导入sqlalchemy，部署后验证：

import azure.functions as func
import sqlalchemy

def main(req: func.HttpRequest) -> func.HttpResponse:
    return func.HttpResponse(f"sqlalchemy版本: {sqlalchemy.__version__}", status_code=200)

若该版本正常，说明原代码存在其他依赖或路径问题；若仍报错，可锁定为云端环境配置问题。

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