Visual Studio发布至Azure App Service的配置部署与读取问题

我正在使用Visual Studio 2022构建ASP.NET Core（v6）应用程序，需部署到Azure App Services实例。appsettings.json包含大量配置项且已被包含在部署包中，通过VS发布功能部署成功后，appsettings.json的配置项并未显示在App Services的配置刀片里。

问题： #

1. 是否可通过Visual Studio的发布功能将appsettings.json的配置部署至App Services的配置刀片？
2. 部署成功后，应用似乎忽略了appsettings.json中的配置，本地开发环境可正常读取，但部署至App Services后无法读取，原因是什么？

更新1：Program.cs与appsettings.json #

Program.cs代码 #

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    builder.Logging.ClearProviders();
    builder.Logging.AddConsole();
    builder.Logging.AddAzureWebAppDiagnostics();

    // Add services to the container.
    builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddMicrosoftIdentityWebApi(builder.Configuration.GetSection("AzureAd"));

    builder.Services.AddControllers();
    // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddSwaggerGen();

    builder.Services.AddApplicationInsightsTelemetry();
    builder.Services.AddScoped<Framework>();
        

    var app = builder.Build();

    // Configure the HTTP request pipeline.
    if (app.Environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseHttpsRedirection();

    app.UseAuthentication();
    app.UseAuthorization();


    app.MapControllers();

    app.Run();
}

appsettings.json内容可任意，只需像本地Visual Studio运行时那样通过ConfigurationManager实例读取其内容。

问题解答 #

问题1：是否可通过Visual Studio发布功能将appsettings.json配置同步到App Services配置刀片？ #

• 默认情况下，Visual Studio的发布功能不会自动将appsettings.json里的配置项同步到Azure App Services的配置刀片（应用程序设置/连接字符串）中。发布过程仅会将appsettings.json文件打包部署到App Service的文件系统，不会解析文件内容并导入到配置刀片。
• 若需要将配置项迁移到配置刀片，可通过以下方式实现：
  • 手动在Azure门户的App Service配置刀片中添加对应配置项；
  • 使用Azure CLI脚本批量导入配置；
  • 借助第三方工具或自定义发布任务实现自动同步，但VS自带发布功能无原生支持。

问题2：部署后应用无法读取appsettings.json配置的原因 #

从你的Program.cs代码来看，WebApplication.CreateBuilder(args)默认已包含appsettings.json的配置加载逻辑，部署到Azure后无法读取的常见原因如下：

1. 配置加载优先级问题：Azure App Service的应用程序设置（配置刀片中的项）优先级高于本地appsettings.json。如果配置刀片存在同名配置项，会覆盖appsettings.json的值；若代码依赖的配置项未在配置刀片中定义，需检查appsettings.json是否真的部署到了App Service的文件系统中。
2. appsettings.json未正确部署：可通过Azure门户的高级工具 > Kudu > 调试控制台查看site/wwwroot目录下是否存在appsettings.json，以及文件内容是否正确。
3. 环境特定配置覆盖：ASP.NET Core会根据环境加载对应配置文件，比如生产环境会加载appsettings.Production.json，如果该文件存在并覆盖了原配置，会导致无法读取appsettings.json中的值。
4. 文件权限问题：极少数情况下，App Service的运行身份没有读取appsettings.json的权限，可通过Kudu确认文件是否能正常访问。
5. 配置读取方式错误：确保代码中通过IConfiguration实例读取配置（你的代码中builder.Configuration.GetSection("AzureAd")是正确方式），若其他地方有直接读取文件的逻辑，部署后可能失效。

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