Consul中存路由规则必须严格匹配网关约定的key路径与value格式：Spring Cloud Gateway要求key以config/gateway/routes/开头、value为含id/uri/predicates的JSON；Traefik v2+要求key带@consul后缀、value为TOML；Go网关需显式指定watch路径且避免点号，否则变更不生效。
Consul里存路由规则，key路径和value格式必须严格匹配网关预期
网关不会自动识别任意键值对——它只认自己约定的路径和结构。存错位置或格式，等于没写。
-
spring.cloud.gateway类网关要求 key 以config/gateway/routes/开头，每个 route 单独一个 key，value 是纯 JSON 字符串，必须含id、uri、predicates字段 -
Traefikv2+ 要求 key 形如traefik/http/routers/myapi@consul，value 是 TOML 片段，且@consul后缀不可省略 - Go 自研网关通常自定义前缀，比如
gateway/routes/或proxy/config/，但必须在代码里显式指定 watch 路径，否则 consul kv 变更完全不触发更新 - 避免在 key 中用点号（
.），某些 Go 客户端会误解析为嵌套字段；改用连字符（-）更稳妥 - 写入时务必加
-从 stdin 读取，否则consul kv put gateway/routes/user '{...}'实际写入空内容
Go 网关启动后不加载 Consul 新增路由，大概率是 watch 机制没生效
Consul 的 watch 不是“实时推送”，而是长轮询 + 服务端事件通知，中间任何一环断开都会静默失败。
- 确认网关代码中调用了
consulapi.NewClient并设置了WatchWaitTime，且初始化了watch.KeyPrefix对应你存路由的路径 - Spring Cloud Gateway 需显式配
spring.cloud.consul.config.watch.enabled=true和format=KEY_VALUE；Go 原生实现则需手动启 goroutine 调watch.Run - watch 默认间隔常为 10 秒，不是毫秒级响应；若 Consul 集群多节点，确保网关连接的是 leader 节点，否则事件可能丢失
- 查日志有没有
Watch returned new results或retrying watch，没有说明 watch 根本没跑起来；出现ConsulClientException多因 ACL 权限不足或限流触发
用 httputil.ReverseProxy 实现动态转发时，Director 函数必须重写 req.URL
原生 ReverseProxy 不知道你要代理到哪，所有路由逻辑都得在 Director 里手工拼接 URL，漏掉任何一步都会 404 或转发到错误地址。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 不能只改
req.URL.Host，必须完整重写req.URL.Scheme、req.URL.Host、req.URL.Path，尤其注意Path是否带前缀（比如路由配置是/api/user，后端期望接收/user，就得手动截掉） - 从 Consul 拉到的服务实例列表（如
[http://10.0.1.5:8081, http://10.0.1.6:8081]）需做负载均衡，简单轮询可用原子计数器，生产环境建议用balancer库或一致性哈希 - 转发前记得清理
req.Header中可能干扰后端的字段，如X-Forwarded-For、Connection，否则某些服务会拒绝请求 - 如果后端是 gRPC，
ReverseProxy不支持，得换grpc-go的proxy包或用envoy作桥接
熔断和限流规则也走 Consul，但必须独立管理生命周期
路由、熔断、限流三类配置虽然都存在 Consul，但更新频率、作用域、生效方式完全不同，混在一起容易互相干扰。
立即学习“go语言免费学习笔记（深入）”；
- 路由变更需重建
http.ServeMux或刷新router实例，而熔断器（如mercari/go-circuitbreaker）是 per-instance 的，新增节点要单独 new 一个，不能复用旧实例 - 限流规则（如按 IP 或 UA）需在每次请求时解析，不能只在启动时加载一次；推荐用
sync.Map缓存已编译的限流器，避免重复 regexp.Compile - Consul 返回的配置是 raw bytes，JSON 解析失败会导致整块配置丢弃；务必用
json.Unmarshal+errors.Is判断，别让 panic 波及主线程 - 本地 fallback 配置很重要：Consul 不可用时，网关至少能按内置默认路由继续工作，而不是直接 panic exit
