ASP.NET Core 8 Web API部署Azure遇500错误：Github Secrets配置异常

核心问题 #

你当前的GitHub Action配置存在关键误区：在Publish和Deployment步骤中定义的env变量，仅作用于GitHub Action的运行环境，并不会自动同步到Azure App Service的应用设置/环境变量中。这导致你的Azure应用始终无法获取到JWT密钥和数据库连接字符串，从而引发HTTP 500错误。

修正步骤 #

1. 更新GitHub Action配置，将Secrets同步到Azure App Service #

推荐使用Azure官方的Azure/appservice-settings@v1动作，直接将GitHub Secrets注入到Azure App Service的应用设置中。修改后的YAML配置如下：

name: Publish

on:
  workflow_dispatch:
  push:
    branches:
    - main

env:
  AZURE_WEBAPP_NAME: my-gym
  AZURE_WEBAPP_PACKAGE_PATH: "./publish"

jobs:
  publish:
    runs-on: windows-latest

    steps:
    - uses: actions/checkout@v3

    - name: Setup .NET
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: "8.0.100"

    - name: Restore
      run: dotnet restore ./mygym.sln

    - name: Build
      run: dotnet build ./mygym.sln --configuration Release --no-restore

    - name: Publish
      run: dotnet publish ./mygym.sln --configuration Release --no-build --output '${{ env.AZURE_WEBAPP_PACKAGE_PATH }}'

    # 新增步骤：将GitHub Secrets同步到Azure App Service应用设置
    - name: Configure Azure App Service Settings
      uses: Azure/appservice-settings@v1
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        app-settings-json: |
          {
            "SMS_CLIENT_SECRET": "${{ secrets.SMS_CLIENT_SECRET }}",
            "SMS_CLIENT_ID": "${{ secrets.SMS_CLIENT_ID }}",
            "JWT_AUDIENCE": "${{ secrets.JWT_AUDIENCE }}",
            "JWT_ISSUER": "${{ secrets.JWT_ISSUER }}",
            "JWT_REFRESH_SECRET": "${{ secrets.JWT_REFRESH_SECRET }}",
            "JWT_SECRET": "${{ secrets.JWT_SECRET }}"
          }
        connection-strings-json: |
          {
            "DefaultConnection": {
              "value": "${{ secrets.DB_CONNECTION_STRING }}",
              "type": "SQLAzure"
            }
          }

    - name: Deployment
      uses: Azure/webapps-deploy@v2
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }}

2. 验证ASP.NET Core配置读取逻辑 #

确保你的应用在读取配置时，正确优先读取环境变量（Azure App Service的应用设置会自动映射为环境变量）：

在Program.cs中确认配置顺序：

var builder = WebApplication.CreateBuilder(args);

// 默认已包含环境变量读取，无需额外配置，但可显式指定优先级
builder.Configuration
    .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true)
    .AddEnvironmentVariables(); // 这一步会读取Azure应用设置映射的环境变量

3. 排查HTTP 500错误的具体原因 #

如果同步设置后仍有错误，需查看Azure的日志详情：

• 登录Azure门户，进入你的App Service
• 在左侧菜单选择监控 > 日志流，实时查看应用运行日志
• 或查看部署中心 > 日志，检查部署过程中是否有报错
• 启用诊断设置，收集更详细的错误信息

额外说明 #

• 手动在Azure添加的设置未生效，可能是因为应用未重启，或者配置键名与代码中读取的键名不一致（注意大小写敏感）
• 数据库连接字符串建议通过connection-strings-json配置，而非普通应用设置，Azure会自动加密这类敏感信息

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