GitHub Actions部署Python Azure Function时azure.identity导入失败

核心原因 #

这个问题本质是依赖版本兼容性冲突：azure.identity依赖cryptography库，但Azure Functions消费计划的Python 3.11运行时环境，与GitHub Actions中自动安装的cryptography新版本存在兼容性问题，导致无法导入x509模块；而VS Code部署时使用本地已调试好的依赖环境，避开了这个冲突。

具体解决方案 #

1. 锁定依赖版本 #

修改requirements.txt，明确指定兼容的azure-identity和cryptography版本，避免自动拉取最新版引发冲突：

azure-functions>=1.17.0
# 指定稳定兼容的azure-identity版本
azure-identity==1.13.0
# 锁定cryptography版本，解决x509导入问题
cryptography==39.0.1
# 其他项目依赖...

2. 优化GitHub Actions部署流程 #

在工作流的依赖安装步骤中，强制重新安装依赖，确保环境干净无残留：

- name: Install dependencies
  run: |
    python -m pip install --upgrade pip
    # 强制重新安装，避免缓存的旧依赖干扰
    pip install --force-reinstall -r requirements.txt

3. 验证运行时环境一致性 #

• 登录Azure Portal，进入你的函数应用，在配置 > 常规设置中确认Python版本为3.11，与本地开发环境一致。
• 检查函数应用的高级工具(Kudu)，进入site/wwwroot目录，查看requirements.txt是否正确上传，以及__pycache__或.python_packages中的依赖版本是否符合预期。

4. 查看详细错误日志 #

GitHub Actions的部署日志可能不会显示函数启动的错误，需要到Azure Portal查看：

• 进入函数应用的监控 > 日志，开启日志流，查看函数启动时的详细报错信息，确认是否还有其他依赖冲突。

为什么VS Code部署正常？ #

VS Code的Azure Functions扩展在部署时，默认会使用本地已安装的依赖包（或通过虚拟环境同步），而本地环境已经通过调试解决了依赖兼容性问题；而GitHub Actions是在全新的虚拟机环境中安装依赖，没有本地缓存的兼容版本，因此暴露了版本冲突问题。

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