.NET Minimal API中AddJsonFile与环境变量的正确使用

先看你贴的这段代码：

builder.Configuration
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings{builder.Environment.EnvironmentName}.json", optional: true, reloadOnChange: true);

问题出在配置提供程序的添加顺序：.NET的配置系统遵循「后添加的提供程序覆盖先添加的」规则。如果你的代码是直接在默认builder.Configuration上追加JSON，而ASP.NET Core的WebApplication.CreateBuilder默认已经自动添加了环境变量、命令行等提供程序，那把JSON加在后面就会让配置文件覆盖环境变量的值——这和我们通常需要的「环境变量动态覆盖配置文件」逻辑完全相反。

解答你的两个疑问 #

1. 是否只需注意避免覆盖环境变量的值即可？ #

不是。核心不是避免值重复，而是要控制配置提供程序的添加顺序。正确逻辑是：优先级低的基础配置先加，优先级高的动态配置后加。比如JSON配置是基础默认值，优先级低；环境变量、命令行是运维/部署时的动态调整项，优先级高，应该后添加，这样它们能覆盖配置文件的设置。

如果只是单纯避免值重复，后续新增配置项时一旦出现冲突，还是会出现不符合预期的覆盖问题。所以顺序才是关键，而非仅仅规避值的重复。

2. 是否需要显式调用AddEnvironmentVariables()？ #

分两种场景：

• 如果你用的是ASP.NET Core模板生成的WebApplication.CreateBuilder，默认已经自动添加了环境变量配置提供程序，包括用户机密、环境变量、命令行等。这种情况下，只需在builder.Configuration上按需追加配置源即可，不需要显式调用。
• 但如果你手动清空了默认配置源（比如调用builder.Configuration.Clear()），或者需要自定义环境变量前缀（比如AddEnvironmentVariables("MYAPP_")），那就必须显式调用AddEnvironmentVariables()来添加。

正确的实现方式 #

方式一：保留默认配置（推荐，适用于Web项目） #

默认情况下，WebApplication.CreateBuilder的配置优先级顺序是：

1. 内存配置
2. 用户机密（仅开发环境）
3. appsettings.json
4. appsettings.{Environment}.json
5. 环境变量
6. 命令行参数

如果需要追加自定义JSON文件，直接在默认配置链上添加即可，默认顺序已经保证环境变量会覆盖JSON：

// 保留默认配置源（含环境变量、命令行等），追加自定义JSON文件
builder.Configuration
    .AddJsonFile("custom-settings.json", optional: true, reloadOnChange: true);

方式二：完全自定义配置（适用于控制台项目或需要完全控制的场景） #

如果需要完全掌控配置链，按「优先级从低到高」的顺序添加：

var builder = new ConfigurationBuilder()
    // 低优先级：基础JSON配置
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production"}.json", optional: true)
    // 高优先级：环境变量，覆盖前面的JSON配置
    .AddEnvironmentVariables()
    // 最高优先级：命令行参数，覆盖所有前面的配置
    .AddCommandLine(args);

var configuration = builder.Build();

这样就能保证环境变量、命令行的配置可以动态覆盖JSON文件的默认值，符合生产环境的最佳实践——无需修改配置文件，就能通过环境变量快速调整配置。

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