如何在Azure Web App及本地统一通过IConfiguration访问应用设置？

一、正确配置Azure应用设置键名 #

在Azure Web App的应用设置中，需将嵌套配置的冒号:替换为双下划线__，也就是配置键名为AppSettings__LASTFM_API_KEY。.NET配置系统读取环境变量（Azure应用设置会自动转换为环境变量）时，会自动将双下划线解析为冒号，这样代码里的configuration["AppSettings:LASTFM_API_KEY"]就能正确匹配到对应值。

注意：检查键名拼写，确保下划线是两个，大小写尽量和代码保持一致（.NET配置默认不区分大小写，但可避免不必要的问题）。

二、确认配置加载顺序 #

确保Program.cs使用默认的配置构建逻辑，环境变量（Azure应用设置）优先级高于本地配置，默认代码如下：

var builder = WebApplication.CreateBuilder(args);
// 默认已包含环境变量加载，无需额外配置

如果自定义了配置加载流程，要保证AddEnvironmentVariables()被正确添加，且顺序在本地配置之后，确保Azure设置能覆盖本地值。

三、验证配置是否生效 #

若仍无法访问，可通过以下方式排查：

• 在代码中临时添加调试代码，输出所有配置项（仅限开发/调试阶段使用）：

  foreach (var configPair in configuration.AsEnumerable())
  {
      Console.WriteLine($"{configPair.Key} = {configPair.Value}");
  }
  

  发布到Azure后，查看日志确认AppSettings:LASTFM_API_KEY是否存在。
• 通过Azure门户的高级工具（Kudu） → 环境选项卡，查看环境变量列表，确认AppSettings__LASTFM_API_KEY已正确存在。

四、实现本地与Azure统一访问方式 #

完全可以实现两端用相同代码访问：

• 本地（secrets.json）配置嵌套结构：

  {
    "AppSettings": {
      "LASTFM_API_KEY": "你的本地密钥"
    }
  }
  

• Azure端配置键名为AppSettings__LASTFM_API_KEY，值为生产环境密钥。
  这样两边都能通过configuration["AppSettings:LASTFM_API_KEY"]直接访问，无需修改代码。

额外排查点 #

• 检查是否存在同名连接字符串：Azure中连接字符串优先级高于应用设置，若有同名项会被覆盖。
• 确认当前部署的Slot是否继承正确配置：如果使用Deployment Slot，需检查Slot的应用设置是否单独配置或继承了主槽设置。

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