Azure函数应用部署中心GitHub Actions部署失败问题排查

• 部署中心授权缺失：私有仓库需要Azure具备访问权限，若最初仅为生产槽授权，Staging槽可能未获取到对应权限。需进入Staging槽的部署中心，重新完成GitHub授权流程，确认Azure的OAuth应用或服务主体有权限访问目标私有仓库。

• 仓库路径格式错误：GitHub仓库路径区分大小写，检查部署中心填写的仓库路径（如username/repository）是否与实际完全一致，避免多余空格、.git后缀或大小写偏差。

• GitHub分支/仓库权限限制：

  • 确认GitHub中Staging分支未设置严格的保护规则，导致Azure无法读取分支内容；
  • 检查仓库的「Manage access」设置，确保Azure授权的账号/应用拥有仓库的读取权限。

• 部署槽身份验证配置异常：

  • 若使用OAuth授权，可能授权令牌已过期或未正确关联到Staging槽，需重新授权；
  • 若使用个人访问令牌（PAT），确认令牌具备repo权限且未过期，部署中心配置的令牌正确无误。

结合提供的GitHub Actions YAML补充排查点 #

从你提供的工作流文件来看，当前使用的是GitHub Actions部署而非部署中心自动部署，需额外注意：

• 确认YAML中app-name和slot-name与Azure函数应用、Staging部署槽的名称完全匹配（区分大小写）；
• 检查Azure登录所用的Secrets（AZUREAPPSERVICE_CLIENTID等）对应的服务主体，是否拥有目标函数应用部署槽的Contributor权限；
• 若同时配置了部署中心和GitHub Actions，建议暂时禁用其中一种部署方式，避免冲突导致部署异常。

# Docs for the Azure Web Apps Deploy action: https://github.com/azure/functions-action
# More GitHub Actions for Azure: https://github.com/Azure/actions

name: Build and deploy dotnet core app to Azure Function App - myfunction123456789

on:
  push:
    branches:
      - staging
  workflow_dispatch:

env:
  AZURE_FUNCTIONAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root
  DOTNET_VERSION: '8.0.x' # set this to the dotnet version to use

jobs:
  build-and-deploy:
    runs-on: windows-latest
    permissions:
      id-token: write #This is required for requesting the JWT

    steps:
      - name: 'Checkout GitHub Action'
        uses: actions/checkout@v4

      - name: Setup DotNet ${{ env.DOTNET_VERSION }} Environment
        uses: actions/setup-dotnet@v1
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}

      - name: 'Resolve Project Dependencies Using Dotnet'
        shell: pwsh
        run: |
          pushd './${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}'
          dotnet build --configuration Release --output ./output
          popd
      
      - name: Login to Azure
        uses: azure/login@v2
        with:
          client-id: ${{ secrets.AZUREAPPSERVICE_CLIENTID_ABCDEFGHIJK }}
          tenant-id: ${{ secrets.AZUREAPPSERVICE_TENANTID_ABCDEFGHIJK }}
          subscription-id: ${{ secrets.AZUREAPPSERVICE_SUBSCRIPTIONID_ABCDEFGHIJK }}

      - name: 'Run Azure Functions Action'
        uses: Azure/functions-action@v1
        id: fa
        with:
          app-name: 'myfunction123456789'
          slot-name: 'staging'
          package: '${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}/output'

内容的提问来源于stack exchange，提问作者Age of Empires