ASP.NET Core：修改appsettings.json后重新初始化BotSettings单例（用IOptions）

核心思路 #

利用IConfiguration的文件变更监听机制，在appsettings.json修改后自动触发单例实例的配置重载，同时保留直接使用单例的逻辑（无需依赖IOptionsSnapshot）。关键是开启配置文件的自动重载，并订阅配置变更事件来更新单例属性。

步骤1：改造BotSettings类 #

让单例类支持配置重载，添加Update方法用于重新绑定配置值，同时处理线程安全问题：

public class BotSettings
{
    // 你的配置属性示例
    public string BotToken { get; set; }
    public int MaxRetryCount { get; set; }
    public bool EnableDebugMode { get; set; }

    private readonly object _updateLock = new object();

    // 重载配置的方法
    public void Update(IConfiguration configuration)
    {
        lock (_updateLock)
        {
            // 将最新配置绑定到当前实例
            configuration.GetSection("BotSettings").Bind(this);
        }
    }
}

步骤2：注册单例并开启配置自动重载 #

在Program.cs中注册BotSettings为单例，同时确保appsettings.json开启reloadOnChange：

var builder = WebApplication.CreateBuilder(args);

// 加载appsettings.json并开启文件变更自动重载
builder.Configuration.AddJsonFile(
    "appsettings.json",
    optional: false,
    reloadOnChange: true // 关键：开启文件变更监听
);

// 注册BotSettings单例，初始绑定配置
builder.Services.AddSingleton<BotSettings>(sp =>
{
    var settings = new BotSettings();
    sp.GetRequiredService<IConfiguration>()
      .GetSection("BotSettings")
      .Bind(settings);
    return settings;
});

var app = builder.Build();

步骤3：订阅配置变更事件，自动更新单例 #

在Program.cs中获取配置根实例，订阅Reloaded事件，触发BotSettings的重载：

// 获取配置根（必须转为IConfigurationRoot才能订阅事件）
var configRoot = (IConfigurationRoot)app.Services.GetRequiredService<IConfiguration>();
var botSettings = app.Services.GetRequiredService<BotSettings>();

// 订阅配置重载完成事件
configRoot.Reloaded += (sender, e) =>
{
    botSettings.Update(configRoot);
    // 可选：日志输出确认更新
    Console.WriteLine($"[{DateTime.Now}] BotSettings已更新：Token={botSettings.BotToken}, RetryCount={botSettings.MaxRetryCount}");
};

手动触发配置重载（可选） #

如果是通过代码修改appsettings.json，写完文件后可以手动调用Reload()立即触发更新，避免依赖文件系统的延迟通知：

// 假设你已经完成appsettings.json的写入操作
var configRoot = app.Services.GetRequiredService<IConfigurationRoot>();
configRoot.Reload(); // 手动触发配置重载，会立即触发Reloaded事件

关键注意事项 #

• 属性可写性：BotSettings的配置属性必须是可写的（不能用init或只读属性），否则Bind方法无法更新值。
• 线程安全：如果应用是多线程环境，一定要在Update方法中加锁，避免并发更新导致的数据不一致。
• 配置路径匹配：确保GetSection("BotSettings")的名称和appsettings.json中的配置节点完全一致。

内容的提问来源于stack exchange，提问作者AMB