配置重载使ASP.NET Core应用无需重启即可实时更新配置，通过reloadOnChange: true实现文件监听，结合IOptionsSnapshot<T>（请求级快照）和IOptionsMonitor<T>（实时通知）让应用感知变化，适用于动态调整参数、功能开关、安全凭证轮换等场景，支持JSON、XML、INI等文件源，还可通过自定义IConfigurationSource和IConfigurationProvider扩展至数据库或远程配置中心，提升系统灵活性与可维护性。

ASP.NET Core 中的配置重载，简单来说，就是让你的应用程序在不重启的情况下，能够实时更新它的配置设置。这就像你开着车，不用停车就能换个收音机频道或者调整一下导航路线，极大地提升了应用的灵活性和响应速度。

解决方案

在ASP.NET Core中实现配置重载，核心在于利用其强大的配置系统。最常见也是最直接的方式，就是通过

appsettings.json

文件，并在加载时设置

reloadOnChange: true

。

public static IHostBuilder CreateHostBuilder(string[] args) =>     Host.CreateDefaultBuilder(args)         .ConfigureAppConfiguration((hostingContext, config) =>         {             config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true);             config.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", optional: true, reloadOnChange: true);             // 其他配置源，如环境变量、命令行等             config.AddEnvironmentVariables();             config.AddCommandLine(args);         })         .ConfigureWebHostDefaults(webBuilder =>         {             webBuilder.UseStartup<Startup>();         });

这里的关键在于

reloadOnChange: true

。当

appsettings.json

文件发生变化时，配置系统会检测到并重新加载。但仅仅是重新加载文件还不够，你的应用程序如何“感知”到这些变化并使用最新的配置呢？这就需要依赖于

IOptionsSnapshot<T>

和

IOptionsMonitor<T>

。

IOptionsSnapshot<T>

：在每个请求（或每个作用域）开始时，它会获取一份当前配置的“快照”。这意味着在一个请求的生命周期内，即使配置文件发生了变化，该请求仍会使用它开始时加载的配置。新的请求才会看到更新后的配置。

IOptionsMonitor<T>

：这是一个单例服务，它提供对当前配置值的实时访问，并且更重要的是，它提供了一个

OnChange

事件。你可以订阅这个事件，以便在配置发生变化时立即得到通知并执行相应的逻辑。这对于需要实时响应配置更新的后台服务、缓存机制等非常有用。

例如，在一个Controller中：

public class MyController : ControllerBase {     private readonly MySettings _settings;      public MyController(IOptionsSnapshot<MySettings> options) // 使用 IOptionsSnapshot     {         _settings = options.Value;     }      [HttpGet]     public IActionResult GetSetting()     {         return Ok(_settings.SomeValue);     } }

而在一个需要实时更新的后台服务中：

public class MyBackgroundService : IHostedService, IDisposable {     private MySettings _currentSettings;     private IDisposable _settingsChangeToken;      public MyBackgroundService(IOptionsMonitor<MySettings> optionsMonitor) // 使用 IOptionsMonitor     {         _currentSettings = optionsMonitor.CurrentValue;         // 订阅配置变化事件         _settingsChangeToken = optionsMonitor.OnChange(updatedSettings =>         {             _currentSettings = updatedSettings;             Console.WriteLine($"配置已更新：{_currentSettings.SomeValue}");             // 在这里执行当配置更新时需要做的逻辑，比如重新初始化客户端、刷新缓存等         });     }      public Task StartAsync(CancellationToken cancellationToken)     {         Console.WriteLine($"服务启动，初始配置：{_currentSettings.SomeValue}");         return Task.CompletedTask;     }      public Task StopAsync(CancellationToken cancellationToken)     {         _settingsChangeToken?.Dispose();         return Task.CompletedTask;     }      public void Dispose() => _settingsChangeToken?.Dispose(); }

为什么我们需要配置重载？它解决了哪些痛点？

配置重载在现代微服务架构和云原生应用中几乎成了标配。我记得有一次，线上环境的一个API限流配置出了问题，如果不能动态调整，那真是得熬夜发布，想想都头疼。配置重载解决的痛点，在我看来主要有以下几个：

首先是减少停机时间。每次只为了修改一个配置参数就得重启整个应用，这对于高可用系统来说是不可接受的。想象一下，你只是想调整一下日志级别或者数据库连接池大小，却要让服务中断几分钟甚至更久，用户体验会大打折扣。配置重载允许我们在线上环境进行参数微调，而无需中断服务。

其次，它为A/B测试和功能开关提供了极大的便利。产品经理想测试某个新功能的效果？或者想逐步灰度发布一个特性？通过动态修改配置，我们可以实时地开启或关闭某个功能，或者调整流量分配比例，而不需要频繁地部署新版本。这大大加快了迭代速度，降低了风险。

再者，安全凭证和敏感信息轮换是另一个重要场景。数据库连接字符串、API密钥、第三方服务凭证等，出于安全考虑，往往需要定期轮换。如果每次轮换都需要重启应用，那操作成本会非常高。配置重载使得这些敏感信息可以在运行时安全地更新。

最后，它也简化了多环境配置管理。开发、测试、生产环境的配置往往差异很大。通过外部化配置并支持重载，我们可以更灵活地管理这些差异，比如使用Azure App Configuration、Consul等服务作为配置中心，实现集中式管理和动态分发。

IOptionsSnapshot 和 IOptionsMonitor 有何区别？何时选用它们？

这俩兄弟经常让人混淆，但理解它们的区别对于正确地利用配置重载至关重要。我的经验是，如果你在Controller里用，

IOptionsSnapshot

基本够用。但要是写个后台服务，比如定时任务或者缓存管理器，那就得请出

IOptionsMonitor

了，它能让你“感知”到变化。

Waifulabs

一键生成动漫二次元头像和插图

131

查看详情

IOptionsSnapshot<T>

• 生命周期： 作用域（Scoped）。这意味着在每个HTTP请求或每个

  IServiceScope

  中，你都会得到一个全新的

  IOptionsSnapshot<T>

  实例。

• 行为： 它在作用域开始时获取配置的“快照”。如果在同一个请求处理过程中，配置文件发生了变化，这个请求仍然会使用它开始时加载的旧配置。新的请求才会获取到更新后的配置。
• 适用场景： 主要用于ASP.NET Core的Web应用，例如Controller、Middleware、Filter等。当你希望配置变化在下一个请求才生效，或者不希望一个请求中途因为配置变化而行为不一致时，

  IOptionsSnapshot

  是理想选择。它避免了频繁地重新读取配置，提高了性能。

IOptionsMonitor<T>

• 生命周期： 单例（Singleton）。整个应用程序只会有一个

  IOptionsMonitor<T>

  实例。

• 行为： 它提供对当前配置值的实时访问。当配置源发生变化时，

  IOptionsMonitor

  会立即更新其内部值，并通过

  OnChange

  事件通知所有订阅者。

• 适用场景： 适用于需要实时响应配置变化的长生命周期服务，如后台任务（

  IHostedService

  ）、缓存管理器、消息队列消费者、或者任何需要立即根据配置变化调整行为的组件。例如，一个后台服务可能需要根据配置中的数据库连接字符串变化来重新初始化数据库客户端。

总结何时选用：

• 选择

  IOptionsSnapshot

  ： 当你的组件是短生命周期的（如Web请求），且你希望配置变化在下一个请求才生效，或者不希望单个请求的执行过程中配置突然改变时。

• 选择

  IOptionsMonitor

  ： 当你的组件是长生命周期的（如后台服务），且你需要立即感知配置变化并采取行动时。

// 示例：在后台服务中监听配置变化 public class CacheService : IHostedService {     private readonly IOptionsMonitor<CacheSettings> _cacheMonitor;     private IDisposable _changeToken;     private CacheSettings _currentSettings;      public CacheService(IOptionsMonitor<CacheSettings> cacheMonitor)     {         _cacheMonitor = cacheMonitor;         _currentSettings = _cacheMonitor.CurrentValue; // 获取初始配置     }      public Task StartAsync(CancellationToken cancellationToken)     {         Console.WriteLine($"CacheService started with TTL: {_currentSettings.DefaultCacheTTLSeconds}");         // 订阅配置变化事件         _changeToken = _cacheMonitor.OnChange(newSettings =>         {             _currentSettings = newSettings;             Console.WriteLine($"CacheSettings updated! New TTL: {_currentSettings.DefaultCacheTTLSeconds}");             // 这里可以添加逻辑，比如刷新缓存策略、清除旧缓存等         });         return Task.CompletedTask;     }      public Task StopAsync(CancellationToken cancellationToken)     {         _changeToken?.Dispose();         return Task.CompletedTask;     } }

除了JSON文件，还有哪些配置源支持重载？如何自定义配置源？

除了我们最常用的

appsettings.json

这类JSON文件，ASP.NET Core的配置系统设计得非常灵活，理论上几乎所有基于文件的配置源都可以通过设置

reloadOnChange: true

来支持重载，例如：

• XML文件：

  config.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true);
• INI文件：

  config.AddIniFile("appsettings.ini", optional: true, reloadOnChange: true);

然而，对于环境变量、命令行参数和用户机密（User Secrets）等配置源，它们通常是在应用启动时加载的，并且在应用程序运行期间不会动态“重载”。它们的值是静态的，除非你重启应用或重新部署。

真正的强大之处在于自定义配置源。这允许你从任何地方获取配置，并使其支持重载。比如从数据库、远程API（如Consul、etcd、Azure App Configuration）、甚至是一个自定义的文件格式。

实现自定义配置源通常需要以下几个步骤：

1. 创建自定义

   IConfigurationSource

   ： 这是一个简单的类，它告诉配置构建器如何创建你的配置提供程序。

   public class CustomDbConfigurationSource : IConfigurationSource {     public IConfigurationProvider Build(IConfigurationBuilder builder)     {         return new CustomDbConfigurationProvider();     } }

2. 创建自定义

   IConfigurationProvider

   ： 这是核心部分。它负责实际地加载配置数据，并实现重载机制。这个类需要继承

   ConfigurationProvider

   。

   public class CustomDbConfigurationProvider : ConfigurationProvider, IDisposable {     // 假设这里有一个定时器或者其他机制来检测数据库配置的变化     private Timer _timer;      public CustomDbConfigurationProvider()     {         // 初始化时加载一次配置         Load();         // 启动一个定时器，每隔一段时间检查数据库是否有更新         _timer = new Timer(CheckForChanges, null, TimeSpan.FromSeconds(30), TimeSpan.FromSeconds(30));     }      public override void Load()     {         // 从数据库加载配置数据         var data = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);         // 模拟从数据库加载数据         data["MySettings:DbValue"] = $"ValueFromDb_{DateTime.Now.Ticks}";         data["MySettings:OtherSetting"] = "SomeOtherValue";          Data = data; // 更新基类的Data属性         Console.WriteLine("Loaded config from custom DB source.");     }      private void CheckForChanges(object state)     {         // 模拟检测到数据库配置有变化         // 实际应用中，这里会去查询数据库，比较版本号或者监听数据库事件         if (ShouldReload()) // 假设有一个逻辑判断是否需要重载         {             Load(); // 重新加载配置             OnReload(); // 通知配置系统，配置已更新             Console.WriteLine("Custom DB config reloaded.");         }     }      private bool ShouldReload()     {         // 实际逻辑：查询数据库中的配置版本号，与当前内存中的版本号比较         // 这里简单模拟，每次都认为有变化         return true;     }      public void Dispose()     {         _timer?.Dispose();     } }

3. 在

   IConfigurationBuilder

   中添加自定义源：

   public static IHostBuilder CreateHostBuilder(string[] args) =>     Host.CreateDefaultBuilder(args)         .ConfigureAppConfiguration((hostingContext, config) =>         {             // ... 其他配置源             config.Add(new CustomDbConfigurationSource()); // 添加自定义配置源         })         .ConfigureWebHostDefaults(webBuilder =>         {             webBuilder.UseStartup<Startup>();         });

自定义配置源听起来很酷，但实现起来可不简单。特别是要处理好并发、错误重试、以及如何高效地检测变更。我曾经尝试从数据库加载配置，一开始觉得简单，后来发现要考虑的细节太多了，比如如何避免频繁查询数据库，如何处理数据库连接失败等等，这可比简单的

appsettings.json

复杂多了。但它的价值在于，它给了你完全的自由来构建一个符合你应用特定需求的配置管理方案。对于分布式系统，结合Azure App Configuration或HashiCorp Consul这类专业的配置服务，会是更稳健的选择，因为它们已经帮你处理好了很多底层细节。