微服务中不能用 net/http.ServeMux 做动态路由，因其仅支持静态前缀匹配，无法支持路径重写、服务发现、Header分流、灰度发布等能力，需改用反向代理中间件并结合外部配置中心实现热更新路由表。
微服务里用 net/http.ServeMux 做服务映射行不通
它只支持静态前缀匹配，比如注册 /api/user 就只能匹配以该字符串开头的路径，没法做路径重写、服务发现或按 header 分流。你一旦需要灰度、权重、健康检查，就得自己补全整套逻辑——而这不是路由层该干的事。
常见错误现象：http.HandleFunc("/v1/users", handler) 写死在代码里，上线后改个路径就得发版；或者试图用 http.StripPrefix 把 /api/v1 映射到后端 /v2，结果发现请求体、header 全丢了，因为没透传。
- 所有动态映射必须脱离
ServeMux，改用反向代理中间件（如httputil.NewSingleHostReverseProxy）接管请求流转 - 路径重写不能靠注册时“猜”，得在 handler 里显式修改
c.Request.URL.Path或构造新 URL - 若需保留原始 host、header、body，代理前必须调用
c.Request.Header.Set("X-Forwarded-For", c.ClientIP())等手动透传，NewSingleHostReverseProxy默认不带这些
基于 Gin 的动态路由表必须运行时热更新
硬编码 gin.Engine 的 GET/POST 调用等于放弃动态能力。真正有效的做法是把路由规则存在外部配置中心（Consul/Etcd/Nacos），启动时加载，再用中间件查表转发。
使用场景：API 网关收到 POST /order/create，查路由表发现应转发至 order-service:8081，且该服务当前有 3 个健康实例，选一个代理过去。
立即学习“go语言免费学习笔记（深入）”；
- 路由表结构建议用
[]struct{Path string; Method string; ServiceURL string; Timeout time.Duration}，避免嵌套过深影响序列化 - 监听配置变更时，别用轮询，优先用 Consul 的
Watch或 Etcd 的Watch接口，减少无效请求 - 查表匹配必须同时校验
c.Request.Method和c.Request.URL.Path，否则GET /health可能被误匹配成POST /health
Istio VirtualService 的 Weight 字段容易写错
不是“加起来接近 100 就行”，而是总和必须严格等于 100。写成 60 + 30，Istio 会直接忽略这条 HTTP 路由规则，流量 fallback 到默认 destination，而不是按比例分发。
错误示例：Weight: 70 和 Weight: 25 —— 这会导致 5% 流量丢失，且无日志提示，排查时只会看到部分请求 503。
-
HTTP字段必须是[]*networking.HTTPRoute，每个元素都得是指针，写成值类型会被静默丢弃 -
Hosts字段不能为空切片（[]string{}）也不能为nil，生产环境应显式设为[]string{"my-svc.default.svc.cluster.local"} - 更新资源时务必先
Get()当前对象，提取ResourceVersion，再带版本号提交，否则并发更新会触发409 Conflict
Consul 实例标签过滤要手动解析，不是开箱即用
Consul 的 Tags 是字符串切片，比如 ["env=staging", "region=us-east"]，没有键值对结构。你想按 X-Env: staging 头分流，就得自己遍历 tag 并用 strings.Contains(tag, "env=staging") 匹配。
容易踩的坑：用 strings.EqualFold 或忽略大小写匹配 tag，但 Consul 标签本身是区分大小写的；或者把 env: staging（冒号空格）当标准格式，实际 Consul 不认这种写法。
- 建议统一用
key=value格式打标，避免空格、斜杠等特殊字符 - 过滤逻辑必须放在代理层，不能依赖 Consul 查询时的
TagFilter参数——它只支持精确匹配单个 tag，不支持模糊或复合条件 - 健康实例列表缓存后，每次路由前都要重新过滤，不能把 “env=staging” 实例单独缓存一份，否则 tag 变更时无法及时同步
