Dictionary配置段绑定Options时值始终为空的问题排查

问题根源 #

你的TenantsOptions类结构和appsettings.json里的配置段不匹配，导致绑定逻辑出错：

• 配置中"Tenants"节点直接包含First、Second这类键值对；
• 当你调用services.Configure<TenantsOptions>(Configuration.GetSection("Tenants"))时，框架会把"Tenants"节点下的每一项映射到TenantsOptions的同名属性上。但你的TenantsOptions里只有一个嵌套的Tenants字典属性，配置里根本没有"Tenants"节点下的子节点"Tenants"，所以这个字典始终是空的。

两种可行解决方案 #

方案一：保持原有类结构，手动绑定 #

不需要修改TenantsOptions，只需要调整ConfigureServices里的绑定逻辑，直接把配置段绑定到Tenants属性：

public void ConfigureServices(IServiceCollection services)
{
    // ...
    services.Configure<TenantsOptions>(options =>
    {
        Configuration.GetSection("Tenants").Bind(options.Tenants);
    });
    // 其他服务配置...
}

方案二：调整Options类结构（更简洁） #

让TenantsOptions直接继承字典类型，和配置结构完全对齐：

public class Tenant
{
    public string Name { get; set; }
}

// 直接继承Dictionary，匹配配置的键值对结构
public class TenantsOptions : Dictionary<string, Tenant>
{
}

然后正常绑定即可：

services.Configure<TenantsOptions>(Configuration.GetSection("Tenants"));

控制器里使用时，直接访问字典的Values：

[HttpGet("tenants")]
public IActionResult GetTenants()
{
    var tenants = _tenantsOptions.Values;
    return Ok(tenants);
}

这两种方案都能通过DI获取正确的配置值，你可以根据自己的代码习惯选择。

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