.NET Core中IConfiguration的GetValue<T>返回null异常问题

根本原因 #

IConfiguration.GetValue<T> 是为读取基础单值类型设计的扩展方法，仅会读取指定配置Key对应的直接Value值并做类型转换，不支持复杂类的递归属性绑定。
你读取的Authentication:ApiConfig是包含Url、Username、Password三个子节点的配置段，该节点本身没有直接的Value值，因此调用GetValue<ApiConfig>返回null属于设计预期行为，并非系统异常。

解决方法 #

以下3种方式均可实现复杂类型的配置绑定： #

方法1：使用配置段的Get<T>()扩展方法（最常用） #

直接在目标配置段上调用Get<T>()，自动完成所有公共属性的匹配绑定：

public static void Test(IConfiguration configuration)
{
    var key = "Authentication:ApiConfig";
    // 成功返回填充完成的ApiConfig实例
    var config = configuration.GetSection(key).Get<ApiConfig>();
}

提示：如果编译找不到Get<T>()方法，请确认项目已引用Microsoft.Extensions.Configuration.Binder NuGet包，ASP.NET Core Web项目默认自带该引用，类库项目需手动安装。

方法2：使用Bind()方法填充已有实例 #

如果需要复用已创建的ApiConfig实例，可以调用Bind()方法写入配置值：

var config = new ApiConfig();
configuration.GetSection("Authentication:ApiConfig").Bind(config);

方法3：全局注册配置（适合多处使用的场景） #

在Startup.cs的ConfigureServices方法中注册配置绑定，后续通过依赖注入直接获取实例：

// 服务注册阶段绑定配置
public void ConfigureServices(IServiceCollection services)
{
    services.Configure<ApiConfig>(Configuration.GetSection("Authentication:ApiConfig"));
    // 其他服务注册...
}

// 业务代码中注入使用
public class DemoService(IOptions<ApiConfig> apiConfigOptions)
{
    private readonly ApiConfig _apiConfig = apiConfigOptions.Value;
}

内容的提问来源于stack exchange，提问作者Xavier Peña