Azure App服务中配置的连接字符串无法通过环境变量获取求助

核心原因排查及对应解决方法 #

• 配置源加载时机错误
  你的代码中先尝试读取连接字符串，之后才调用builder.Configuration.AddEnvironmentVariables()。尽管WebApplicationBuilder默认已自动添加环境变量配置源，但这种顺序会导致首次读取时环境变量未被正确加载（逻辑上存在错误）。调整代码顺序，确保读取配置前完成配置源加载：

  static void ConfigurationEnvironmentVariablesNecessaryToInitializeServices(WebApplicationBuilder builder)
  {
      // 确保环境变量配置源已加载（默认已包含，此处可省略；若有自定义前缀可在此配置）
      builder.Configuration.AddEnvironmentVariables();
      
      string issueIdentityAPIConfigConnectionString = builder.Configuration.GetConnectionString("AppConfig");
      
      if (string.IsNullOrEmpty(issueIdentityAPIConfigConnectionString))
      {
          issueIdentityAPIConfigConnectionString = Environment.GetEnvironmentVariable("CUSTOMCONNSTR_AppConfig");
      }
      
      if (string.IsNullOrEmpty(issueIdentityAPIConfigConnectionString))
      {
          throw new Exception("Connection string was null in both builder.Configuration.GetConnectionString(\"AppConfig\") and Environment.GetEnvironmentVariable(\"CUSTOMCONNSTR_AppConfig\")");
      }
  }
  

• 连接字符串类型不匹配
  Azure App Service中不同类型的连接字符串会生成不同前缀的环境变量：

  • Custom类型 → CUSTOMCONNSTR_
  • SQL Azure → SQLAZURECONNSTR_
  • SQL Server → SQLCONNSTR_
  • MySQL → MYSQLCONNSTR_
    确认你在App Settings中配置的连接字符串类型为Custom，否则对应环境变量前缀会不符，导致CUSTOMCONNSTR_AppConfig无法被读取。

• 部署槽位配置未同步
  若使用了Azure部署槽位，当前运行的槽位可能未配置该连接字符串，或槽位配置未与生产槽交换。检查当前运行槽位的App Settings，确认连接字符串已正确设置。

• 应用未完全重启
  发布后应用可能未彻底重启，导致环境变量未刷新。手动在Azure Portal的应用服务页面点击"重启"按钮，强制应用重新加载配置。

• Linux计划下的大小写问题
  若应用服务为Linux计划，环境变量名称区分大小写。检查KUDU中显示的环境变量名称大小写是否与代码中CUSTOMCONNSTR_AppConfig完全一致。

• 配置源优先级冲突
  检查appsettings.json、appsettings.Production.json等配置文件中是否存在同名的AppConfig连接字符串且值为空。默认环境变量优先级高于配置文件，但如果自定义了配置源顺序，可能导致配置文件覆盖环境变量。可通过以下代码打印所有配置内容排查：

  foreach (var config in builder.Configuration.AsEnumerable())
  {
      Console.WriteLine($"{config.Key}: {config.Value}");
  }
  

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