.NET 7 Clean Architecture下IOptionsSnapshot嵌套接口实例化失败问题

问题根源 #

.NET配置绑定系统默认会尝试直接实例化接口类型，但接口本身无法被实例化。你的场景中Core层定义了嵌套的配置接口（IMyApiOptions包含ISubSettingsOptions类型属性），直接绑定接口会触发Cannot create instance of type 'ISubSettingsOptions'异常。

可行解决方案 #

方案1：绑定实现类后映射到接口

先让配置系统绑定Web层的具体实现类，再手动将实例映射到Core层的接口：

假设你的实现类定义如下：

// Web层实现
public class MyApiOptions : IMyApiOptions
{
    public SubSettingsOptions SubSettings { get; set; } = new();
}

public class SubSettingsOptions : ISubSettingsOptions
{
    public string ApiUrl { get; set; } = string.Empty;
    public int Timeout { get; set; }
}

在Program.cs中注册：

// 先绑定具体实现类的配置
builder.Services.Configure<MyApiOptions>(builder.Configuration.GetSection("MyApi"));

// 将实现类的配置映射到接口选项
builder.Services.AddOptions<IMyApiOptions>()
    .Configure<IOptions<MyApiOptions>>((apiOpts, concreteOpts) =>
    {
        apiOpts.SubSettings = concreteOpts.Value.SubSettings;
        // 其他顶层属性也需要手动赋值
        // apiOpts.OtherSetting = concreteOpts.Value.OtherSetting;
    });

方案2：直接注册接口的实现实例

如果不需要配置热重载，可以直接绑定实现类并注册为接口实例：

var myApiConfig = builder.Configuration.GetSection("MyApi").Get<MyApiOptions>()!;
builder.Services.AddSingleton<IMyApiOptions>(myApiConfig);

需要热重载的话，结合IOptionsSnapshot实现：

builder.Services.AddOptions<MyApiOptions>().Bind(builder.Configuration.GetSection("MyApi"));

builder.Services.AddScoped<IMyApiOptions>(sp =>
{
    var concreteOpts = sp.GetRequiredService<IOptionsSnapshot<MyApiOptions>>().Value;
    return concreteOpts;
});

方案3：手动绑定嵌套配置

直接手动读取配置节点并赋值给接口选项，适合嵌套层级较少的场景：

builder.Services.Configure<IMyApiOptions>(opts =>
{
    var myApiSection = builder.Configuration.GetSection("MyApi");
    opts.SubSettings = myApiSection.GetSection("SubSettings").Get<SubSettingsOptions>()!;
    // 绑定其他属性
    // opts.ApiKey = myApiSection.GetValue<string>("ApiKey");
});

注意事项 #

• 确保Web层的实现类完全实现Core层的接口，包括所有嵌套属性的具体实现。
• 如果使用配置热重载，优先选择方案2的IOptionsSnapshot或方案1的AddOptions方式，避免直接注册静态实例。

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