使用GitHub Actions部署Flex Consumption函数应用时无法检测.NET版本

问题原因 #

你遇到的Error: Couldn't detect a version for the platform 'dotnet' in the repo错误，是因为Azure/functions-action@v1在处理预构建包时，仍尝试从仓库根目录自动检测.NET版本，但当前配置下，构建输出目录缺少足够的版本标识文件，或者参数组合导致检测逻辑冲突。

修复步骤 #

1. 调整构建命令，生成完整的版本配置文件 #

修改构建步骤的dotnet build命令，添加--self-contained false参数（依赖Azure托管运行时场景），确保输出目录包含.runtimeconfig.json文件（该文件存储明确的.NET版本信息）：

pushd './${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}'
dotnet build --configuration Release --output ./output --self-contained false
popd

2. 在部署步骤中明确指定.NET版本 #

在Run Azure Functions Action步骤里添加dotnet-version参数，跳过自动检测逻辑，直接指定版本：

- name: 'Run Azure Functions Action'
  uses: Azure/functions-action@v1
  id: fa
  with:
    sku: flexconsumption
    remote-build: true
    scm-do-build-during-deployment: false
    enable-oryx-build: false
    app-name: ${{ env.AZURE_FUNCTIONAPP_NAME }}
    package: '${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}/output'
    dotnet-version: ${{ env.DOTNET_VERSION }} # 新增该行，明确指定版本

3. 仓库根目录添加全局版本文件（可选兜底方案） #

如果上述方法仍无效，在仓库根目录创建global.json文件，直接声明.NET版本：

{
  "sdk": {
    "version": "8.0.x"
  }
}

这样部署动作会从根目录直接读取版本信息，避免检测失败。

4. 验证Azure函数应用的运行时配置 #

登录Azure门户，进入目标函数应用，检查配置 > 常规设置中的.NET版本是否设置为8，确保远程运行时与本地构建版本一致。

完整修正后的工作流示例 #

name: Deploy DotNet project to Azure Function App

on:
  push:
    branches: ["main"]

env:
  AZURE_FUNCTIONAPP_NAME: 'function app name'   
  AZURE_FUNCTIONAPP_PACKAGE_PATH: '.'       
  DOTNET_VERSION: '8.0.x'                   

jobs:
  build-and-deploy:
    runs-on: windows-latest # For Linux, use ubuntu-latest
    environment: dev
    steps:
    - name: 'Checkout GitHub Action'
      uses: actions/checkout@v4

    - name: Setup DotNet ${{ env.DOTNET_VERSION }} Environment
      uses: actions/setup-dotnet@v3
      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 --self-contained false
        popd

    - name: 'Run Azure Functions Action'
      uses: Azure/functions-action@v1
      id: fa
      with:
        sku: flexconsumption
        remote-build: true
        scm-do-build-during-deployment: false
        enable-oryx-build: false
        app-name: ${{ env.AZURE_FUNCTIONAPP_NAME }}
        package: '${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}/output'
        dotnet-version: ${{ env.DOTNET_VERSION }}

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