Python Azure Function App通过GitHub Actions ZIP部署失败求助

1. 确认本地构建产物完整性 #

既然已禁用部署阶段自动构建（SCM和Oryx均关闭），必须确保GitHub Actions流水线中先执行了完整的本地构建：

• 针对.NET项目，需运行dotnet publish --configuration Release --output ./publish生成部署包
• 针对Python项目，要确认依赖已正确安装，且产物包含__pycache__、.python_packages等必要目录和文件
• 检查流水线中构建步骤的日志，确保无报错，构建产物目录结构符合Function App要求

2. 核对functions-action的部署路径 #

如果构建产物不在默认目录，需在action中通过package参数指定正确路径，示例：

- name: Deploy to Azure Function App
  uses: Azure/functions-action@v1
  with:
    app-name: your-function-app-name
    package: ./publish  # 此处需与本地构建输出路径完全一致
    scm-do-build-during-deployment: false
    enable-oryx-build: false

3. 验证WEBSITE_RUN_FROM_PACKAGE配置影响 #

WEBSITE_RUN_FROM_PACKAGE: 0表示不启用包部署模式，部署时需将文件直接同步至Function App文件系统：

• 确认构建产物包含host.json、各函数目录等完整文件
• 确保流水线或functions-action能正确识别并上传这些文件

4. 查看详细错误日志 #

• 在GitHub Actions流水线详情中，查看functions-action步骤的日志，定位具体错误（如文件缺失、权限问题、连接超时）
• 登录Azure门户，进入Function App的部署中心，查看部署历史的详细日志，获取Azure侧的具体失败原因

5. 排查配置冲突 #

• 检查Function App应用设置中是否存在其他触发构建的参数（如BUILD_FLAGS），避免与当前禁用构建的配置冲突
• 确认本地构建产物的运行时版本（.NET/Python版本）与Function App应用设置中的FUNCTIONS_EXTENSION_VERSION、对应语言版本参数匹配

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