配置重载使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等服务作为配置中心，实现集中式管理和动态分发。
这俩兄弟经常让人混淆，但理解它们的区别对于正确地利用配置重载至关重要。我的经验是，如果你在Controller里用，
IOptionsSnapshot
IOptionsMonitor
IOptionsSnapshot<T>
IServiceScope
IOptionsSnapshot<T>
IOptionsSnapshot
IOptionsMonitor<T>
IOptionsMonitor<T>
IOptionsMonitor
OnChange
IHostedService
总结何时选用：
IOptionsSnapshot
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;
}
}除了我们最常用的
appsettings.json
reloadOnChange: true
config.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true);config.AddIniFile("appsettings.ini", optional: true, reloadOnChange: true);然而，对于环境变量、命令行参数和用户机密（User Secrets）等配置源，它们通常是在应用启动时加载的，并且在应用程序运行期间不会动态“重载”。它们的值是静态的，除非你重启应用或重新部署。
真正的强大之处在于自定义配置源。这允许你从任何地方获取配置，并使其支持重载。比如从数据库、远程API（如Consul、etcd、Azure App Configuration）、甚至是一个自定义的文件格式。
实现自定义配置源通常需要以下几个步骤：
创建自定义IConfigurationSource
public class CustomDbConfigurationSource : IConfigurationSource
{
public IConfigurationProvider Build(IConfigurationBuilder builder)
{
return new CustomDbConfigurationProvider();
}
}创建自定义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();
}
}在IConfigurationBuilder
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((hostingContext, config) =>
{
// ... 其他配置源
config.Add(new CustomDbConfigurationSource()); // 添加自定义配置源
})
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});自定义配置源听起来很酷，但实现起来可不简单。特别是要处理好并发、错误重试、以及如何高效地检测变更。我曾经尝试从数据库加载配置，一开始觉得简单，后来发现要考虑的细节太多了，比如如何避免频繁查询数据库，如何处理数据库连接失败等等，这可比简单的
appsettings.json
以上就是ASP.NET Core中的配置重载是什么？如何实现？的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
328
