.NET 6.0从指定appsettings.json读取字符串数组异常问题求助

问题背景 #

你的项目包含两个配置文件：

• appsettings.json（生产环境）：Contacts.Emails包含7个邮箱（email3至email9）
• appsettings.Development.json（开发环境）：Contacts.Emails包含2个邮箱（email1、email2）

但无论当前环境是开发还是生产，通过IOptions<Contacts>获取到的Emails数组总是合并后的结果（email1、email2加上email5至email9），而其他配置字段能正常按环境切换。

核心原因 #

ASP.NET Core的配置系统默认对集合类型（数组、列表）执行合并操作，而非完全替换。当环境配置文件与基础配置文件存在同名集合节点时，环境配置的元素会追加到基础配置的集合中，而不是覆盖整个集合。单值类型（如字符串、数字）则会直接覆盖，这就是其他字段正常但数组异常的原因。

解决方案 #

方法1：绑定配置时强制替换集合 #

修改Program.cs中配置Contacts的代码，使用Bind方法并启用Replace选项，让环境配置的数组完全替换基础配置的数组：

builder.Services.Configure<Contacts>(options =>
{
    builder.Configuration.GetSection("Contacts").Bind(options, bindOptions =>
    {
        bindOptions.Replace = true; // 开启集合替换模式
    });
});

方法2：直接获取配置实例并注册 #

跳过IOptions的默认绑定逻辑，直接从配置中获取完整的Contacts实例并注册为单例，这样环境配置会完全覆盖基础配置的所有内容（包括数组）：

1. 修改Program.cs：

// 直接从配置节获取Contacts实例
var contactsConfig = builder.Configuration.GetSection("Contacts").Get<Contacts>();
// 注册为单例服务
builder.Services.AddSingleton(contactsConfig);

2. 修改StoreDataService的构造函数，直接注入Contacts而非IOptions<Contacts>：

private readonly Contacts _contactSettings;

public StoreDataService(IOptions<DatabaseSettings> dbSettings, Contacts contactSettings) : base(dbSettings)
{
    _dbSettings = dbSettings.Value;
    _contactSettings = contactSettings;
    string[] emailList = _contactSettings.Emails;
}

额外验证步骤 #

确保环境变量ASPNETCORE_ENVIRONMENT已正确设置为Development或Production，可以在Program.cs中添加输出验证：

Console.WriteLine($"当前运行环境：{builder.Environment.EnvironmentName}");

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