Azure Linux应用服务部署的.NET 5.0嵌套应用配置未生效问题

1. 优先检查Azure应用服务配置规则 #

• Linux环境下嵌套配置的分隔符要求为双下划线__，你使用的ImageProcessingConfig__CompressionQualityPercentage格式正确，接下来要核对两个细节：
  • 配置大小写：Linux环境下环境变量区分大小写，需确保配置项的拼写、大小写和代码里的配置类、绑定key完全一致
  • 槽位匹配：如果使用了部署槽，要确认配置是添加到当前正在运行的槽位，且勾选了部署槽位设置避免槽位切换时配置丢失

2. 修正配置绑定逻辑 #

你当前绑定代码中用到的ImageProcessingOptions.ImageProcessingConfig常量，需确认它的取值完全等于字符串ImageProcessingConfig，常量拼写错误是配置绑定失效的高频原因。
你可以替换成更稳妥的绑定写法规避拼写问题：

// 直接通过配置节绑定，不依赖常量
Configuration.GetSection("ImageProcessingConfig").Bind(imageProcessingOptions);

// 更推荐使用框架原生的IOptions注入方案，无需手动实例化配置类
services.Configure<ImageProcessingOptions>(Configuration.GetSection("ImageProcessingConfig"));
// ImageProcessor构造函数改为接收IOptions<ImageProcessingOptions>参数即可
services.AddScoped<IImageProcessor, ImageProcessor>();

3. 排查配置加载结果 #

Host.CreateDefaultBuilder的默认加载顺序为：appsettings.json → 环境特定appsettings文件 → 环境变量 → 命令行参数，Azure配置会以环境变量形式注入，优先级高于本地配置。如果还是不生效可以加临时日志确认配置读取情况：

// 在ConfigureServices方法中添加以下代码
var readConfigValue = Configuration.GetValue<int>("ImageProcessingConfig:CompressionQualityPercentage");
Console.WriteLine($"读取到的压缩质量配置：{readConfigValue}");

在Azure控制台的日志流中查看打印结果，如果值和你配置的一致，说明问题出在绑定逻辑；如果值和appsettings.json里的默认值一致，说明Azure配置没有成功注入到应用环境。

4. 自定义容器特殊检查 #

如果是自定义Linux容器部署，需确认容器启动命令没有覆盖.NET默认的配置源，也没有修改ASPNETCORE_*相关的环境变量配置。

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