ASP.NET Core 中的选项快照如何获取配置变更?

来源:这里教程网 时间:2026-02-21 17:28:33 作者:

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 并理解其作用域生命周期。

相关推荐