.NET 4.8中Azure App Configuration绑定数组配置失败问题

核心原因 #

.NET Framework 4.8/.NET Standard 2.0的ConfigurationBinder在处理接口类型集合（比如IEnumerable<IDictionary<string, string>>）时，对Azure App Configuration的键值对结构解析逻辑和appsettings.json的JSON序列化逻辑存在差异——JSON可以自动推断并实例化字典类型，但AAC的键值对绑定器无法自动为接口类型创建实例，导致绑定失败。

解决方案 #

1. 替换POCO中的接口类型为具体实现 #

把EntraConfiguration里的ClientCredentials属性类型从IEnumerable<IDictionary<string, string>>改成List<Dictionary<string, string>>：

public class EntraConfiguration
{
    public string TenantId { get; set; }
    public string Instance { get; set; }
    // 替换为具体可实例化的类型
    public List<Dictionary<string, string>> ClientCredentials { get; set; }
}

修改后再执行configuration.Bind("AzureAd", entraConfiguration)，绑定器就能正常识别并实例化集合和字典对象。

2. 验证Azure App Configuration的键结构 #

确保AAC中的键严格遵循以下格式：

• AzureAd:ClientCredentials:0:SourceType
• AzureAd:ClientCredentials:0:ClientSecret
• AzureAd:ClientCredentials:1:SourceType（如果存在多个凭据）

可以在代码中先输出所有配置键值对，确认这些键已被正确加载：

foreach (var kvp in configuration.AsEnumerable())
{
    Console.WriteLine($"{kvp.Key} = {kvp.Value}");
}

3. 手动绑定（备用方案） #

如果上述方法仍不生效，可手动读取配置并构建集合：

var entraConfig = new EntraConfiguration();
// 绑定其他属性
configuration.Bind("AzureAd", entraConfig);

// 手动构建ClientCredentials
var credsList = new List<Dictionary<string, string>>();
int index = 0;
while (true)
{
    var credSection = configuration.GetSection($"AzureAd:ClientCredentials:{index}");
    if (!credSection.Exists()) break;
    
    var credDict = credSection.GetChildren()
                              .ToDictionary(child => child.Key, child => child.Value);
    credsList.Add(credDict);
    index++;
}
entraConfig.ClientCredentials = credsList;

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