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(builder.Configuration.GetSection(“MyOptions”));
在控制器中使用:
public class HomeController : Controller
{
private readonly IOptionsSnapshot _options;
public HomeController(IOptionsSnapshot options)
{
_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 并理解其作用域生命周期。
以上就是ASP.NET Core 中的选项快照如何获取配置变更?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1440799.html
微信扫一扫
支付宝扫一扫