.NET 6控制台应用中AppSettings无法绑定到IOptions的问题

问题场景 #

在.NET 6控制台应用中，无法将appsettings.json的配置绑定到IOptions<T>，注入后属性全为默认值。相关代码如下：

appsettings.json #

{
    "MyOptionsSettings" : {
       "Foo": 100,
       "Bar": true
    }
}

MyOptions.cs #

public class MyOptions 
{
   public int Foo {get; set;}
   public bool Bar {get; set;}
}

program.cs #

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

var builder = Host.CreateDefaultBuilder(args);

builder.ConfigureServices((hostContext, services) => 
{
    var configuration = hostContext.Configuration;
    services.Configure<MyOptions>(opts => configuration.GetSection("MyOptionsSettings"));
    services.AddTransient<MyService>();
});

var app = builder.Build();
var myService = app.Services.GetService<MyService>();

MyService.cs #

public class MyService 
{
    // ...
    public MyService(IOptions<MyOptions> options)
    {
       _options = options;
    } 
    // ...
}

问题更新 #

修改program.cs中的配置代码后，IOptions<T>可以正常绑定：
原代码：

services.Configure<MyOptions>(opts => configuration.GetSection("MyOptionsSettings"));

修改为：

services.Configure<MyOptions>(opts => configuration.GetSection("MyOptionsSettings").Bind(opts));

但微软官方文档中使用的是不带.Bind(opts)的写法，想了解这两行代码的区别。

回答 #

核心差异分析 #

1. 原代码的问题
   你写的services.Configure<MyOptions>(opts => configuration.GetSection("MyOptionsSettings"));只是在lambda表达式里返回了配置节对象，但没有对传入的opts实例做任何赋值操作。这个lambda的作用是接收一个MyOptions实例并对其进行配置，而你的代码完全没修改这个实例，所以最终注入的是默认值的MyOptions。

2. 修改后代码的作用
   configuration.GetSection("MyOptionsSettings").Bind(opts)是显式调用配置绑定方法，将配置节中的键值对映射到opts实例的属性上，这样opts就能正确获取到appsettings.json里的配置值。

3. 官方文档的写法
   微软官方文档里常用的简化写法是services.Configure<MyOptions>(configuration.GetSection("MyOptionsSettings"));——注意这里没有lambda，直接传入配置节对象。这是因为IServiceCollection有重载的Configure<T>方法，当传入IConfiguration对象时，内部会自动调用绑定逻辑，帮你完成配置到T实例的映射，和你手动调用.Bind(opts)的效果一致。你之前错误地用了带lambda的重载，但没在lambda里执行绑定操作，才导致失败。

关于IOptionsMonitor的动态更新 #

如果你要实现配置动态更新，只需要把注入的IOptions<MyOptions>换成IOptionsMonitor<MyOptions>即可，不需要额外修改配置注册代码（用官方的services.Configure<MyOptions>(configuration.GetSection("MyOptionsSettings"));写法就行）。IOptionsMonitor<T>会自动监听配置文件的变化，在文件更新时重新加载配置。

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