appsettings含子对象时，.NET Options绑定后子属性为null的解决方法

问题场景 #

我的appsettings配置内容如下：

{"ClassA": {"ClassB": {"ConnectionString": "Testing"}}}

对应的C#类定义：

public class ClassA
{
    public ClassB ClassB { get; set; }
}

public class ClassB
{
    public string ConnectionString { get; set; }
}

我在Program.cs中按以下方式注册Options：

builder.Services.AddOptions<ClassA>()
        .Bind(configuration.GetSection("ClassA"));

但将IOptions<ClassA>注入到类中时，ClassB子属性始终为null，请问该如何正确绑定包含子属性的Options？

解决方案 #

出现这个问题的核心是子属性未被自动实例化，以下几种方法可以解决：

1. 初始化子属性实例 #

在父类中直接为子属性创建实例，绑定框架会自动填充子属性的内容：

public class ClassA
{
    public ClassB ClassB { get; set; } = new ClassB();
}

2. 显式配置嵌套绑定规则 #

使用Bind方法的重载，明确配置绑定规则（默认已支持嵌套绑定，显式配置更清晰）：

builder.Services.AddOptions<ClassA>()
        .Bind(configuration.GetSection("ClassA"), bindOptions =>
        {
            bindOptions.BindNonPublicProperties = false; // 无需绑定私有成员时保持默认即可
        });

3. 使用推荐的Configure方法注册 #

.NET Core官方更推荐使用Configure方法注册Options，它会自动处理嵌套属性的绑定逻辑，代码更简洁：

builder.Services.Configure<ClassA>(configuration.GetSection("ClassA"));

以上三种方式都能解决子属性为null的问题，其中第三种是最常用的标准写法。

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