Azure App Service如何读取配置菜单自定义环境变量而非web.debug.config

问题分析 #

你的代码通过Environment.GetEnvironmentVariable读取变量，但部署到Azure后仍获取web.debug.config中的值，核心原因大概率是web.config变换逻辑意外覆盖了Azure配置，或是Azure配置的变量名与代码不匹配，也可能存在部署残留导致本地配置未被云端设置替换。

解决步骤 #

1. 确认Azure配置的变量一致性 #

• 登录Azure门户进入目标App Service，打开「配置」→「应用程序设置」
• 确保自定义变量名称完全为TARGET_ENVIRONMENT（Azure应用设置大小写不敏感，但代码读取时尽量保持一致避免跨环境问题），变量值设置为Azure（对应代码中的Environments.Azure）

2. 阻止本地配置文件的不必要覆盖 #

检查web.debug.config和web.release.config的变换规则：

• 移除web.debug.config中TARGET_ENVIRONMENT的定义，避免部署时该值被带入云端环境
• 打开web.release.config，确保没有针对appSettings节点下的TARGET_ENVIRONMENT做硬编码变换，让云端配置优先生效

3. 改用ASP.NET原生配置系统读取（更可靠） #

对于ASP.NET应用，使用框架原生的配置读取方式会自动优先加载Azure应用设置，避免本地配置干扰：

• .NET Framework 传统项目：

  using System.Configuration;
  
  public static string GetPathString() 
  {
    string targetEnv = ConfigurationManager.AppSettings["TARGET_ENVIRONMENT"];
    if (string.Equals(targetEnv, Environments.Dev, StringComparison.OrdinalIgnoreCase))
    {
      return "/RCHHRATool/";
    }
    else if (string.Equals(targetEnv, Environments.Azure, StringComparison.OrdinalIgnoreCase))
    {
      return "/";
    }
    return "INVALID ENVIRONMENT SET IN ENVIRONMENT VARIABLES";
  }
  

• .NET Core/.NET 5+ 项目：
  通过依赖注入IConfiguration读取：

  private readonly IConfiguration _configuration;
  
  public YourService(IConfiguration configuration)
  {
    _configuration = configuration;
  }
  
  public string GetPathString() 
  {
    string targetEnv = _configuration["TARGET_ENVIRONMENT"];
    if (string.Equals(targetEnv, Environments.Dev, StringComparison.OrdinalIgnoreCase))
    {
      return "/RCHHRATool/";
    }
    else if (string.Equals(targetEnv, Environments.Azure, StringComparison.OrdinalIgnoreCase))
    {
      return "/";
    }
    return "INVALID ENVIRONMENT SET IN ENVIRONMENT VARIABLES";
  }
  

4. 清理部署残留并重启服务 #

• 部署完成后，在Azure门户的App Service页面点击「重启」，确保新配置完全生效
• 若使用Visual Studio部署，检查部署选项，取消勾选「替换应用程序设置」类选项，防止本地配置覆盖云端设置

验证方式 #

部署后可在App Service的「控制台」中验证变量是否注入成功：

• Windows环境：执行 echo %TARGET_ENVIRONMENT%
• Linux环境：执行 echo $TARGET_ENVIRONMENT
  若能输出Azure配置中设置的值，说明变量已生效，再排查代码读取逻辑即可。

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