IOptionsSnapshot在每次请求时读取最新配置,通过Scoped生命周期和reloadOnChange: true实现配置热更新。

ASP.NET Core 中的选项快照(IOptionsSnapshot)能够在每次请求开始时获取最新的配置,从而反映配置文件的变更。它通过依赖注入在每个请求作用域内重新计算选项值,实现对配置变化的响应。
工作原理:基于请求作用域
IOptionsSnapshot 的核心机制是“每次请求创建一个新的实例”。它在请求开始时读取当前的配置源(如 appsettings.json),因此如果配置文件在此前已重新加载,新请求就能看到更新后的值。
关键点:
- 生命周期为 Scoped,即每个请求使用一个独立的选项实例。
- 依赖 IConfiguration 的变更检测机制(如文件监听)。
- 只有在配置源触发重载后,IOptionsSnapshot 才能获取到新值。
确保配置文件变更被监听
默认情况下,ASP.NET Core 使用 FileConfigurationSource 监听 appsettings.json 文件变化,并自动重载配置。需确认以下设置:
builder.Configuration.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);其中 reloadOnChange: true 是关键,它启用文件系统监听。当文件保存时,IConfiguration 自动刷新,后续请求中 IOptionsSnapshot 就会读取新值。
实际使用示例
定义选项类:
public class MyOptions{
public string Value { get; set; } = string.Empty;
}
注册服务:
builder.Services.Configure在控制器中使用:
public class HomeController : Controller{
private readonly IOptionsSnapshot
public HomeController(IOptionsSnapshot
{
_options = options;
}
public IActionResult Index()
{
var value = _options.Value.Value;
return Content(value);
}
}
每次访问 Index 方法时,都会读取当前最新的配置值。
与 IOptions 和 IOptionsMonitor 的区别
- IOptions:Singleton,启动时读取一次,不响应变更。
- IOptionsSnapshot:Scoped,每次请求读取一次,适合请求级配置变更。
- IOptionsMonitor:Singleton,支持实时变更通知(通过 OnChange 回调),适合高频变更或后台服务。
基本上就这些。只要配置源启用了重载,IOptionsSnapshot 在下一次请求中自然就能拿到新值,无需额外代码干预。关键是确保 reloadOnChange: true 并理解其作用域生命周期。










