IOptions注入后为null的最常见原因是未在Program.cs中正确注册配置绑定，需用Configure()或AddOptions().BindConfiguration()显式绑定，且配置节名须与GetSection()参数完全一致。
为什么 IOptions<t></t> 注入后总是 null？
最常见原因是没在 Program.cs（.NET 6+）或 Startup.cs 中正确注册配置绑定。仅调用 builder.Services.AddOptions() 不够，必须显式绑定到具体类型。
正确做法是：用 Configure<t>()</t> 或 AddOptions<t>().BindConfiguration()</t>。例如配置节名为 "MySettings"，类为 MySettings：
builder.Services.Configure<MySettings>(builder.Configuration.GetSection("MySettings"));如果跳过这步，DI 容器无法解析 IOptions<mysettings></mysettings>，注入点拿到的就是 null。
- 确保配置节名和
GetSection()参数完全一致（区分大小写） -
MySettings类必须是 public，且所有属性为 public set - 不要在构造函数里直接访问
Value—— 此时配置可能尚未加载完成
IOptions<t></t>、IOptionsSnapshot<t></t> 和 IOptionsMonitor<t></t> 怎么选？
三者生命周期和热重载行为不同，选错会导致配置不更新或内存泄漏。
-
IOptions<t></t>：单例，只在应用启动时读取一次，后续修改配置文件无效 -
IOptionsSnapshot<t></t>：Scoped，在每个请求/作用域内首次访问时读取，支持重载（需启用reloadOnChange: true），适合 Web 请求场景 -
IOptionsMonitor<t></t>：Singleton，实时监听变更并触发回调，还支持命名选项（Get("name")），适合后台服务或需要响应变化的组件
多数 Web API 场景推荐用 IOptionsSnapshot<t></t>；若需监听变化（如连接字符串刷新），必须用 IOptionsMonitor<t></t>。
配置绑定失败但没报错？检查这几个地方
绑定静默失败（Value 中字段为默认值）通常因类型不匹配或路径错误，不会抛异常。
- 确认 JSON 配置中字段名与 C# 属性名匹配（默认使用 PascalCase → camelCase 映射，可通过
ConfigureOptions自定义） - 数值型字段（如
int）不能填空字符串或null，否则绑定失败后保留默认值0 - 嵌套对象需对应层级结构，例如
"Database:ConnectionString"对应public Database Database { get; set; }+public class Database { public string ConnectionString { get; set; } } - 数组或集合需用 JSON 数组格式，且目标类型必须是
IEnumerable<t></t>或List<t></t>，不能是普通数组T[]（.NET 7+ 支持，但低版本不行）
在非 DI 环境（如静态方法）里怎么安全读配置？
别试图从 IServiceProvider 手动解析 IOptions<t></t>，容易引发作用域混乱或死锁。
更稳妥的做法是：把配置值提前提取出来，作为参数传入。例如：
var settings = app.Services.GetRequiredService<IOptionsSnapshot<MySettings>>().Value; MyClass.DoWork(settings.TimeoutMs);
或者在服务注册阶段就构建好依赖对象，避免运行时再去查容器。
真正棘手的是中间件或过滤器里的静态上下文访问——这时应改用 IOptionsMonitor<t></t> 并订阅 OnChange，而不是每次去拉 Value。
配置不是全局变量，它的生命周期和解析时机必须和宿主模型对齐，否则看似能跑，上线后一变配置就出问题。
