配置文件热重载核心依赖filesystemwatcher监听文件变化并调用iconfigurationroot.reload()，需同时处理changed/renamed/deleted事件并加延迟防读取未完成文件；.net原生reloadonchange仅对启动时存在文件生效，且多文件叠加时仅最后一个生效；运行时依赖更新须通过ioptionsmonitor或ioptionssnapshot注入，避免使用ioptions；自定义提供程序需保障线程安全与原子替换。
配置文件热重载的核心机制是 FileSystemWatcher
直接靠手动监听文件变化再重新加载配置，是最可控的方式。.NET 自带的 IConfigurationRoot.Reload() 本身不监听文件——它只是个触发器，真正要“感知修改”，得靠 FileSystemWatcher 监控 .json、.xml 或 .ini 文件的 Changed 事件。
常见错误是只监听 Changed，却没处理 Renamed 或 Deleted，导致配置文件被编辑器临时覆盖（如 VS Code 先写 .tmp 再原子替换）时漏触发。建议同时订阅这三类事件，并在回调里加短延迟（比如 Task.Delay(100)）再调用 Reload()，避免读取未写完的文件。
-
FileSystemWatcher的EnableRaisingEvents = true必须显式开启，否则静默失效 - 路径要用
Path.GetFullPath()标准化，避免相对路径在不同工作目录下失效 - 若配置文件在子目录（如
config/appsettings.prod.json），IncludeSubdirectories = false更安全，防止误监其他配置
.NET 6+ 原生支持的 reloadOnChange 为什么有时不生效
在 Host.CreateDefaultBuilder() 或 ConfigurationBuilder.AddJsonFile(..., reloadOnChange: true) 中设为 true，底层其实也是封装了 FileSystemWatcher。但它只对项目启动时已存在的文件起作用；如果运行时动态新增配置文件（比如插件目录下加了个 plugin.config.json），这个开关不会自动接管。
另一个坑是：当多个 AddJsonFile 调用叠加时，只有最后一个指定 reloadOnChange: true 才会生效——前面的会被忽略。调试时可检查 IConfigurationRoot.Providers 列表里每个 provider 是否实现了 IChangeTokenProvider。
- Linux/macOS 下注意文件系统事件权限，Docker 容器需挂载
/proc/sys/fs/inotify并增大max_user_watches -
reloadOnChange在dotnet watch run下可能被二次代理，导致重复 Reload，引发竞态（如配置刚读一半就被又触发一次）
热重载后如何安全更新运行时依赖
光 Reload 配置不够，关键是要让正在使用的服务感知到变更。比如一个 IMyService 依赖 IOptionsMonitor<myconfig></myconfig>，它会自动响应 OnChange 回调；但若你直接 new MyService(config) 或从 IServiceProvider.GetService() 拿单例，那就不会更新。
必须统一走 IOptionsMonitor<t></t> 或 IOptionsSnapshot<t></t> 注入，且确认注册方式匹配：
-
services.Configure<myconfig>(Configuration.GetSection("My"))</myconfig>是基础前提 -
IOptionsMonitor适合长期存活组件（如后台服务），每次访问都拿最新值 -
IOptionsSnapshot适合 Scoped 生命周期（如 MVC Action），每次请求新建实例，确保该次请求内配置一致 - 避免混用
IOptions<t></t>（只在启动时读一次）和热重载场景
自定义配置提供程序的边界与风险
如果配置来自数据库或 HTTP API，FileSystemWatcher 就不适用了，得自己实现 IConfigurationProvider + IChangeToken，并在外部变更源（如消息队列通知）到来时调用 OnReload()。
这类实现容易忽略线程安全：多个线程同时调用 Load() 可能导致配置中间态错乱。务必在 Load() 内部加锁，或用 ConcurrentDictionary 缓存解析结果并原子替换整个数据结构。
还有一点常被忽略：热重载不是万能的。比如连接字符串变更后，已建立的数据库连接池不会自动关闭重连，需要额外触发 SqlConnection.ClearPool() 或设计连接重建逻辑。
