hyperf中consul配置热更新需手动实现轮询监听，因原生watch()阻塞协程且config单例不可变；应使用consulclient::get()配合x-consul-index条件轮询，解析json后调用$config->set()并清缓存、重建依赖实例。
Hyperf 默认的 consul 配置驱动只支持启动时拉取，不自动监听变更。要实现运行时配置热更新，必须手动接入 Consul 的 /v1/kv/ Watch 或轮询（Polling）机制，且需绕过 Hyperf 原生配置缓存层。
Consul Watch 机制在 Hyperf 中为何不能直接用 ConsulClient::watch()
Hyperf 的 consul 组件（hyperf/consul）提供的 ConsulClient::watch() 是阻塞式长连接，会占用协程并无法与 Hyperf 的生命周期（如 OnWorkerStart）安全协同；直接在 Command 或 Listener 中调用会导致协程卡死或进程 hang 住。
- Watch 接口返回的是
Stream（Swoole\Http2\Client 或 Guzzle Stream），不是标准协程可等待对象，需额外封装成Co\Channel或Swoole\Coroutine\Http2\Client手动处理 - Hyperf 的
Config实例是单例且不可变（ArrayConfig内部为只读数组），直接修改$config->set()不会触发已注入的类属性重载 - Consul Watch 的 key 前缀需显式指定，且响应体是 JSON 数组（含
ModifyIndex），不是纯 kv 结构，需自行解析并映射到 PHP 数组
推荐方案：用 ConsulClient::get() + 协程定时轮询 + ConfigInterface::set()
相比 Watch，轮询更可控、易调试、兼容性更好，尤其适合中小规模配置项（AnnotationReader、ProxyManager 等不感知 config 变更）。
- 在
OnWorkerStart中启动一个常驻协程，间隔 3–10 秒调用$consulClient->get($prefix)（注意加?recurse&index=xxx实现条件轮询） - 对比上次响应的
X-Consul-Index头，仅当 index 变化时才解析响应体、转换为扁平化配置（如app.database.host→['app' => ['database' => ['host' => '127.0.0.1']]]） - 调用
$config->set($key, $value)更新配置，但必须同步调用$container->get(ConfigInterface::class)->getProvider()->clearCache()（若使用ConfigProvider） - 对已注入配置的类（如
DbConnection），需监听ConfigChanged事件并手动 reload 实例，否则仍用旧值
如何让 DbConnection 或 HttpClient 感知配置变更
Hyperf 的核心组件不会自动监听 Config 变更，必须主动干预。最简方式是监听 ConfigChanged 事件，在回调中重建实例并替换容器中的单例。
- 注册事件监听器：
ConfigChanged::class => [YourConfigChangeListener::class, 'handle'] - 在
handle()中判断变更 key 是否匹配（如str_starts_with($key, 'databases.') || str_starts_with($key, 'http_client.')） - 调用
$container->get(ConnectionFactory::class)->make(...)或$container->get(HttpClientFactory::class)->create(...)重建实例 - 用
$container->singleton(...)替换原实例，注意清理旧连接（$oldConnection->close()） - 避免高频重建：加锁（
Co\Channel或Atomic）或防抖（debounce 500ms）
关键细节和容易忽略的坑
Consul 配置热更新不是“改完就生效”，中间有多个缓存层级和依赖链需要穿透。最容易被忽略的是 index 比较逻辑和容器单例强引用。
- 不要用
time()或随机 sleep 做轮询间隔，必须依赖 Consul 返回的X-Consul-Index做条件请求（GET /v1/kv/app/?recurse&index=12345），否则浪费带宽且可能漏变更 -
ConsulClient::get()返回的是 raw body（string），需json_decode($body, true)后递归展开Key字段（如app/config/database/host→['app']['config']['database']['host']） - Hyperf 的
Config不支持嵌套 key 的原子 set，$config->set('app.database.host', 'x')会失败，必须先get('app.database')，改完再set('app.database', $new) - 如果用了
hyperf/cache缓存配置（如ArrayCache），需手动$cache->delete('config:xxx')，否则Config::get()仍返回旧值
