.NET Core中如何将动态应用配置绑定到强类型模型

针对你遇到的静态+动态混合配置绑定场景，这里有一套清晰可行的解决方案，基于.NET配置系统实现：

1. 定义匹配配置结构的强类型模型 #

我们拆分配置结构：静态Log部分单独做一个类，动态的test1/test2/test3这类键值对用Dictionary<string, T>接收（键是动态的，但每个值的结构固定）。

// 静态Log配置类
public class LogSettings
{
    public string FileName { get; set; }
}

// 动态项的通用配置类（每个test*都遵循这个结构）
public class DynamicPathConfig
{
    public string Path { get; set; }
    // 配置系统会自动把字符串"0"转换为int类型
    public int DaysToKeep { get; set; }
}

// 根Utility配置类，整合静态和动态部分
public class UtilitySettings
{
    public LogSettings Log { get; set; }
    public Dictionary<string, DynamicPathConfig> DynamicConfigs { get; set; } = new();
}

2. 实现配置绑定逻辑 #

在.NET 6+的Program.cs中，我们可以手动处理静态和动态部分的绑定，确保所有配置都正确映射到强类型模型：

var builder = WebApplication.CreateBuilder(args);

// 初始化配置模型
var utilitySettings = new UtilitySettings();

// 1. 绑定静态Log配置
builder.Configuration.GetSection("Utility:Log").Bind(utilitySettings.Log);

// 2. 遍历Utility下的所有子节点，排除Log后绑定到Dictionary
var utilitySection = builder.Configuration.GetSection("Utility");
foreach (var childSection in utilitySection.GetChildren())
{
    if (childSection.Key != "Log")
    {
        // 把每个动态节点绑定到DynamicPathConfig
        var dynamicConfig = childSection.Get<DynamicPathConfig>();
        utilitySettings.DynamicConfigs.Add(childSection.Key, dynamicConfig);
    }
}

// 将配置模型注册到依赖注入容器，方便后续使用
builder.Services.AddSingleton(utilitySettings);

var app = builder.Build();

// ... 其他中间件配置
app.Run();

如果你更倾向于使用IOptions模式（推荐用于配置场景），可以用配置回调实现：

builder.Services.AddOptions<UtilitySettings>()
    .Configure<IConfiguration>((settings, config) =>
    {
        // 绑定静态Log
        config.GetSection("Utility:Log").Bind(settings.Log);
        
        // 绑定动态配置
        settings.DynamicConfigs = config.GetSection("Utility")
            .GetChildren()
            .Where(section => section.Key != "Log")
            .ToDictionary(
                section => section.Key,
                section => section.Get<DynamicPathConfig>()
            );
    })
    // 可选：添加自定义验证，确保配置合法
    .Validate(settings =>
    {
        if (string.IsNullOrEmpty(settings.Log?.FileName))
            return false;
            
        foreach (var (key, config) in settings.DynamicConfigs)
        {
            if (string.IsNullOrEmpty(config.Path))
                return false;
        }
        return true;
    }, "Utility配置不合法");

3. 在业务代码中使用配置 #

无论是直接注入UtilitySettings还是IOptions<UtilitySettings>，都可以轻松访问静态和动态配置：

public class MyBusinessService
{
    private readonly UtilitySettings _utilitySettings;

    // 直接注入模型（如果用Singleton注册）
    public MyBusinessService(UtilitySettings utilitySettings)
    {
        _utilitySettings = utilitySettings;
    }

    // 或者注入IOptions（推荐，支持配置重载）
    // public MyBusinessService(IOptions<UtilitySettings> utilitySettings)
    // {
    //     _utilitySettings = utilitySettings.Value;
    // }

    public void ProcessConfig()
    {
        // 访问静态Log配置
        var logFilePath = _utilitySettings.Log.FileName;
        Console.WriteLine($"日志文件路径：{logFilePath}");

        // 遍历所有动态配置
        foreach (var (configKey, configValue) in _utilitySettings.DynamicConfigs)
        {
            Console.WriteLine($"[{configKey}] 路径：{configValue.Path}，保留天数：{configValue.DaysToKeep}");
        }
    }
}

额外说明 #

• 类型转换：配置中的Daystokeep是字符串类型，.NET配置系统会自动将其转换为int类型（只要模型属性是int），如果转换失败会抛出异常，你可以添加异常处理或验证逻辑。
• 配置验证：如果需要确保配置的合法性，可以在模型中添加DataAnnotations特性（比如[Required]、[Range]），然后在绑定的时候启用验证。
• 动态键扩展：如果后续新增test4这类动态配置，不需要修改模型，绑定逻辑会自动识别并添加到DynamicConfigs字典中。

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