.NET Core 8使用环境特定配置文件时未加载默认appsettings.json值

1. 配置节点替换而非合并：.NET默认加载JSON配置时，若环境配置文件（如appsettings.local.json）中存在与默认配置文件（appsettings.json）同名的父节点（比如Mctv），会直接替换整个父节点，而非合并子节点。因此你在local文件里定义了Mctv节点但未配置Port时，默认文件里的整个Mctv节点会被覆盖，导致Port值丢失。
2. 手动构建配置破坏默认逻辑：WebApplication.CreateBuilder(args)已经自动完成了标准配置加载流程：
   • 加载appsettings.json
   • 加载appsettings.{Environment}.json
   • 加载环境变量
   • 加载命令行参数
     你手动调用.Build()会重新创建配置对象，覆盖默认加载逻辑，且配置项添加顺序错误（正确顺序应为：默认文件→环境文件→环境变量，保证优先级覆盖逻辑）。

方案1：使用默认配置逻辑（推荐） #

直接移除手动构建配置的代码，WebApplication.CreateBuilder已帮你完成了正确的配置叠加：

var builder = WebApplication.CreateBuilder(args);

// 直接使用builder.Configuration即可，默认已加载所有配置文件
// 示例：绑定配置到实体类
var mctvConfig = builder.Configuration.GetSection("Mctv").Get<MctvConfig>();

默认配置优先级（从低到高，高优先级覆盖低优先级）：

• appsettings.json
• appsettings.{Environment}.json
• 环境变量
• 命令行参数

关键调整：避免父节点替换 #

修改环境配置文件的写法，不要定义完整的父节点，仅写需要覆盖的子节点：
appsettings.local.json调整为：

{
  "Mctv:Run-Environment": "local",
  "Mctv:CORS": {
    // 你的CORS配置内容
  }
}

这种分层键值对的写法会仅覆盖Mctv下的指定子节点，保留默认文件中未被覆盖的Port值。

方案2：手动配置并启用节点合并 #

若必须手动构建配置，可通过配置源选项启用节点合并，同时注意加载顺序：

var builder = WebApplication.CreateBuilder(args);
var environmentName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";

// 清空默认配置（按需使用）
builder.Configuration.Clear();

builder.Configuration
    .SetBasePath(Directory.GetCurrentDirectory())
    // 加载默认配置
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    // 加载环境配置并启用合并
    .AddJsonFile(
        $"appsettings.{environmentName}.json",
        optional: true,
        reloadOnChange: true,
        configureSource: source =>
        {
            source.Options = new JsonSerializerOptions
            {
                PropertyNameCaseInsensitive = true,
                // 启用对象合并逻辑
                WriteIndented = true
            };
        })
    .AddEnvironmentVariables();

// 无需手动调用Build()，builder.Configuration已可直接使用

注：.NET原生JSON配置对深度对象合并的支持有限，方案1的分层键值对写法更稳定可靠。

验证配置加载结果 #

可通过以下代码验证配置是否正确加载：

var port = builder.Configuration["Mctv:Port"];
var runEnv = builder.Configuration["Mctv:Run-Environment"];
Console.WriteLine($"Port: {port}, Run-Environment: {runEnv}");

当ASPNETCORE_ENVIRONMENT设为local时，应输出：Port: 8080, Run-Environment: local

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