.NET 6前缀环境变量读取异常及配置优先级疑惑

问题背景 #

在研究.NET 6配置设置时，在生产Windows服务器上配置了系统环境变量，按微软文档要求使用.AddEnvironmentVariables()扩展方法读取，修改Program.cs代码如下：

var env = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
var config = new ConfigurationBuilder()
       .AddJsonFile("appsettings.json")
       .AddJsonFile($"appsettings.{env}.json", optional: true)
       .AddEnvironmentVariables()
       .Build();

通过var conString = configuration["DBConnection:ConnectionString"];读取环境变量一切正常，但存在两个疑惑：

疑惑1：移除.AddEnvironmentVariables()后仍能读取环境变量，是否因为.NET赋予环境变量更高优先级？ #

不是优先级的原因，而是**.NET 6的最小托管模型默认已包含环境变量读取逻辑**。如果你的项目基于默认Web模板，使用WebApplication.CreateBuilder(args)初始化时，框架会自动向配置构建器中添加.AddEnvironmentVariables()，所以即使你手动构建ConfigurationBuilder时省略了这一行，底层默认逻辑已经帮你完成了环境变量的注册，因此依然能读取到环境变量。

疑惑2：配置前缀.AddEnvironmentVariables(prefix:"P2:")后，读取Name时始终获取Name环境变量的值，而非P2__Name，哪里出错了？ #

这里有两个核心错误点：

1. 前缀格式错误：前缀参数不需要加冒号:，框架约定用双下划线__替代配置路径中的冒号，而前缀匹配是精确匹配字符串。你设置的前缀是P2:，但Windows环境变量不允许包含冒号，P2__Name的前缀实际是P2，无法被P2:匹配，因此该环境变量不会被解析到Name配置键下。
2. 配置源优先级冲突：如果你的配置构建链中同时存在不带前缀的.AddEnvironmentVariables()，它会读取所有无前缀的环境变量（比如Name），且配置源的优先级是后添加的源更高，如果不带前缀的注册在带前缀的后面，就会覆盖带前缀的解析结果。

修正方案：

• 修改前缀为"P2"（去掉冒号），代码如下：

  var config = new ConfigurationBuilder()
         .AddJsonFile("appsettings.json")
         .AddJsonFile($"appsettings.{env}.json", optional: true)
         .AddEnvironmentVariables("P2") // 使用无冒号的前缀
         .Build();
  

• 确保环境变量命名为P2__Name，框架会自动去掉前缀P2，将__转换为配置路径分隔符，最终映射到Name配置键。
• 如果不需要读取无前缀的环境变量，移除配置链中不带前缀的.AddEnvironmentVariables()，避免冲突。

多应用环境变量隔离建议（针对单服务器部署多.NET应用场景） #

为避免不同应用的环境变量冲突，建议给每个应用分配独立的前缀：

1. 应用A设置环境变量为APP1__DBConnection__ConnectionString，应用B设置为APP2__DBConnection__ConnectionString；
2. 在各自的Program.cs中，使用对应前缀注册环境变量：

   // 应用A
   .AddEnvironmentVariables("APP1")
   // 应用B
   .AddEnvironmentVariables("APP2")
   

3. 读取时直接使用configuration["DBConnection:ConnectionString"]即可，框架会自动筛选对应前缀的环境变量。

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