Azure App Service设置优先级及门户配置未覆盖问题排查

首先给出明确结论：

你遇到的配置值未覆盖现象不属于.NET 6 + Azure App Service的默认正常行为。

你贴出的最小化初始化代码如下：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
//builder.Services.AddSingleton... ETC...
var app = builder.Build();

优先级规则说明 #

Azure门户配置页中添加的App Service应用设置、连接字符串，本质是平台在应用启动时自动注入到运行进程的无前缀环境变量。在你使用WebApplication.CreateBuilder(args)默认加载配置的场景下，这类配置的优先级就是你列出的第2级，仅低于命令行参数，优先级高于用户机密、appsettings.{Environment}.json、appsettings.json，正常情况下完全可以覆盖所有json配置文件中的同名键值，你最初的覆盖预期是符合框架默认规则的。

常见故障原因 #

出现json值未被覆盖的问题，通常是以下几类操作错误导致的：

• 门户配置未生效：修改应用设置后未点击配置页顶部的「保存」按钮，或保存后未等待应用自动重启完成就发起请求；如果启用了部署槽位，需确认配置添加在当前对外提供服务的槽位下，而非其他未做流量切换的槽位。
• 自定义配置源打乱了默认优先级：检查builder.Build()之前的代码逻辑，如果你手动调用了builder.Configuration.AddJsonFile()等方法追加配置源，要记住后注册的配置源优先级高于先注册的源，如果把appsettings相关json文件的加载逻辑放到了默认环境变量配置源的注册逻辑之后，json文件中的值就会反过来覆盖Azure注入的环境变量值。
• 配置键名不匹配：.NET配置系统对嵌套配置的键支持两种分隔符，json文件中使用冒号:做层级分隔，环境变量中使用双下划线__做层级分隔。如果你的MyKey1不是根级配置项，而是嵌套在某个配置节点下（例如json中写为"MySection": { "MyKey1": "Value1" }），门户中配置的键名必须写为MySection:MyKey1或MySection__MyKey1才能命中同一个配置项；另外检查键名是否存在前后多余空格、拼写错误，如果使用Linux托管计划，还需确认键名大小写完全一致，避免匹配失败。
• 配置读取逻辑不符合默认规则：如果代码中没有使用框架依赖注入提供的IConfiguration实例读取配置，而是自行通过new ConfigurationBuilder()初始化了独立的配置栈，且没有将环境变量加入配置源列表，就完全读不到Azure注入的应用设置值。
• 发布文件异常：检查项目中appsettings.json、appsettings.Production.json的生成操作属性，如果设置为「始终复制」且发布时未勾选「删除目标位置的额外文件」，可能存在旧版本配置文件残留的问题；同时确认App Service的运行时栈配置为.NET 6，避免框架依赖部署模式下启动逻辑异常导致配置加载错误。

快速排查方法 #

可以临时添加一个调试接口，调用builder.Build().Configuration.GetDebugView()方法输出所有配置项的值和对应的来源提供方，即可快速定位是Azure的环境变量根本没注入到应用中，还是注入后被其他更高优先级的配置源覆盖了。

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