IConfiguration.Get<>()无法读取含空数组属性的配置元素

问题原因 #

你遇到的问题源于位置参数定义的记录类型在配置绑定时的逻辑限制：当Dependencies为空数组时，绑定系统无法将空数组映射到位置参数，会判定该参数未提供，导致无法创建ServerProcessConfig实例，对应的元素直接被跳过。而当数组包含具体元素（比如[0]）时，绑定系统能识别到参数存在，所以可以正常实例化对象。

解决方案 #

方案1：改用属性式记录（最稳妥） #

将位置记录改为带初始化属性的记录，配置绑定系统对属性的支持更完善，能正确处理空数组：

public sealed record ServerProcessConfig
{
    public int Id { get; init; }
    public int[]? Dependencies { get; init; }
}

方案2：给位置参数添加配置键标记 #

如果坚持用位置记录，需要给每个位置参数对应的属性添加ConfigurationKeyName标记，明确配置键与参数的对应关系：

using Microsoft.Extensions.Configuration;

public sealed record ServerProcessConfig(
    [property: ConfigurationKeyName("Id")] int Id,
    [property: ConfigurationKeyName("Dependencies")] int[]? Dependencies);

方案3：启用空集合绑定选项（辅助优化） #

配合上述方案，绑定配置时开启AllowEmptyCollections选项，确保空数组被正确解析：

var servers = configuration
    .GetSection("Servers")
    .Get<List<ServerProcessConfig>>(options => options.AllowEmptyCollections = true)!;

验证效果 #

修改后重新运行代码，appsettings.json中包含空Dependencies的元素会被正确绑定，servers.Count将返回2，符合预期。

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