Kratos配置热更新需先Load()再Watch()，且依赖配置源支持Watcher接口；etcd须用WithPrefix、Polaris/Nacos仅支持全量推送后路径匹配，回调中需手动赋值或调用c.Scan()刷新结构体。
Kratos 的配置热更新不是靠轮询，而是靠配置源实现的 Watcher 接口主动推送变更；只要配置源支持监听（如 etcd、Polaris、Nacos），且你在代码中调用了 Watch() 方法并注册了回调，就能触发热更新。
为什么 config.Watch() 没反应？常见原因排查
多数人卡在这一步：明明写了 c.Watch("key", handler)，但改了配置中心的值却没触发回调。根本原因是：
-
config.Config实例必须在Load()之后才具备 Watch 能力 —— 因为Load()内部会调用配置源的Watch()方法启动监听器，没这步，Watch()只是注册回调，不真正建立连接 - 配置源本身未正确初始化 Watcher：比如
etcd源依赖 clientv3 的Watch()API，若传入的 client 连接失败或权限不足，source.Watch()会返回 error，但 Kratos 默认不暴露这个 error，容易被忽略 - 监听的 key 路径与配置中心实际结构不匹配：Kratos 的
Watch("etc.test.timeout")会尝试匹配配置项的嵌套路径，但 etcd 是扁平 key-value，Polaris/Nacos 是树形结构，需确认你用的配置源是否支持该层级语义（例如 etcd 源只支持前缀监听，不支持精确字段级监听）
etcd 源如何正确启用热更新
etcd v3 的 Watch 机制天然适合热更新，但 Kratos 封装后行为有细节差异：
- 必须使用
WithPrefix("your/config/prefix")选项构造 source，否则Watch()无法知道监听哪个 key 前缀；etcd源不支持单 key 监听，只支持 prefix-level -
config.New()时传入多个 source，优先级高的（后添加的）source 的 Watch 会覆盖低优先级的，但Load()后所有 active source 的 Watch 都会并发运行 - etcd 的变更事件是批量推送的，
Watcher.Next()返回的是整个 prefix 下所有变更后的[]*config.KeyValue，不是单个 key 的 delta —— 所以你的 handler 里别假设只改了一个字段 - 示例关键片段：
client, _ := clientv3.New(clientv3.Config{Endpoints: []string{"127.0.0.1:2379"}}) source := etcd.New(client, etcd.WithPrefix("/app/prod/")) c := config.New(config.WithSource(source)) _ = c.Load() // 必须先 Load，否则 Watch 不生效 _ = c.Watch("timeout", func(key string, value config.Value) { log.Printf("timeout updated to %s", value.String()) })
Polaris/Nacos 源监听字段级变更的限制
和 etcd 不同，Polaris 和 Nacos 本身支持按 DataID + Group 订阅整个配置文件，但 Kratos 的 Watch("a.b.c") 并不会翻译成「只监听 a.b.c 字段」——它只是在收到全量配置后，对内存中的结构做一次路径匹配，再触发回调。这意味着：
- 即使你只改了
etc.test.timeout，Polaris 也会把整个default.yaml推送过来，Kratos 在内存里解析后才比对路径 - 如果你的配置文件很大（>1MB），频繁变更会导致内存拷贝和 GC 压力上升，建议拆小配置文件，按业务域隔离 DataID
- Nacos 源（非官方 contrib）常有人自己封装 viper + fsnotify，这种方案在 Kratos 里无法接入标准
Watch()流程，必须手动 hook 到viper.OnConfigChange，再调用c.Scan()触发重加载 —— 这种不属于 Kratos 原生热更新链路
真正容易被忽略的是：热更新只改变内存中的 config.Value，不会自动刷新已注入的 struct 字段（比如 bc.Etc.Timeout）。你必须在 Watch() 回调里手动赋值，或用 c.Scan(&bc) 全量重绑定 —— 后者更安全，但要注意并发读写冲突。
