如何通过GitHub Actions部署Blazor Server到Azure并启用Staging配置

你的核心问题是：编译时指定的/p:EnvironmentName无法决定运行时的环境配置加载逻辑。Blazor Server作为服务器端运行的应用，是通过ASPNETCORE_ENVIRONMENT环境变量来识别当前环境，进而加载对应appsettings.{Environment}.json的。Azure App Service默认不会自动设置这个变量，所以即使编译时标记了Staging，运行时仍会使用默认的Production环境。

解决步骤 #

1. 在GitHub Actions中为Azure App Service设置运行时环境变量

你需要在部署步骤中，给目标App Service添加ASPNETCORE_ENVIRONMENT应用设置，覆盖默认值。以下是两种实现方式：

方式一：使用azure/webapps-deploy动作（推荐）

在你的build job中，添加部署步骤并配置应用设置：

- name: Deploy to Azure App Service
  uses: azure/webapps-deploy@v2
  with:
    app-name: <你的App Service名称>
    slot-name: staging # 如果使用部署槽，否则可省略
    package: ./web
    # 配置ASPNETCORE_ENVIRONMENT环境变量
    app-settings: |
      [
        {
          "name": "ASPNETCORE_ENVIRONMENT",
          "value": "${{ env.MYAPP_ASPNETCORE_ENVIRONMENT }}",
          "slotSetting": true # 如果是部署槽，设置为true确保槽独立
        }
      ]

方式二：使用Azure CLI命令

如果习惯用CLI，也可以直接执行命令设置：

- name: Configure ASPNETCORE_ENVIRONMENT in App Service
  run: |
    az webapp config appsettings set \
      --name <你的App Service名称> \
      --resource-group ${{ secrets.STAGING_AZURE_RESOURCE_GROUP_NAME }} \
      --settings ASPNETCORE_ENVIRONMENT=${{ env.MYAPP_ASPNETCORE_ENVIRONMENT }}

2. 确认Program.cs的配置加载逻辑（可选）

确保你的应用启动时正确加载环境配置，默认模板已经包含以下逻辑，无需额外修改：

var builder = WebApplication.CreateBuilder(args);

// 按优先级加载配置：appsettings.json → appsettings.{Environment}.json → 环境变量
builder.Configuration
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true, reloadOnChange: true)
    .AddEnvironmentVariables();

3. （可选）手动在Azure Portal配置

如果不想通过CI/CD设置，也可以直接在Azure Portal操作：

• 进入你的App Service → 左侧菜单「配置」→「应用设置」
• 添加新设置：名称ASPNETCORE_ENVIRONMENT，值Staging
• 保存并重启App Service

为什么之前的/p:EnvironmentName无效？ #

dotnet publish /p:EnvironmentName=Staging只会在生成的web.config中添加一个环境变量标记，但Azure App Service的应用设置优先级高于web.config中的配置。如果App Service没有设置ASPNETCORE_ENVIRONMENT，默认会使用Production，导致加载appsettings.json而非appsettings.Staging.json。

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