直接用 httputil.NewSingleHostReverseProxy + 自定义 Director 即可，无需 gorilla/mux 或 gin 运行时注册路由，因其非并发安全且不支持热更新；Director 必须重写 Scheme、Host、Path、X-Real-IP 并清理 hop-by-hop 头，路由需预加载至 sync.Map，Transport 需自定义连接池。
直接用 httputil.NewSingleHostReverseProxy + 自定义 Director 就够了，别碰 gorilla/mux 运行时注册、也别在 gin 里调 Group().GET()——那些写法扛不住热更新，一并发就 panic 或失效。
为什么不能在 handler 里动态注册路由
gorilla/mux 的 Router 和 gin 的 Engine 都不是并发安全的。你如果在 HTTP handler 或中间件里调 router.HandleFunc 或 engine.GET，多个请求同时触发就会触发 map 并发读写 panic。
- gorilla/mux 必须用
sync.RWMutex包住写操作，且只允许在独立的配置监听 goroutine 中执行 - gin 不支持运行时挂载子路由：
engine.Group("/api/v1").GET()在启动后调用完全无效，它只是构建期语法糖 - 常见错误是把路由表查逻辑塞进
Director函数里——每次请求都查 etcd 或 YAML，QPS 上千后网关直接卡死
Director 必须重写的三处，漏一项下游就出问题
不改 Director 就等于裸转：后端看到的是网关本机 IP、原始完整路径、空的 X-Forwarded-For，鉴权和日志全崩。
-
req.URL.Scheme和req.URL.Host必须设为目标后端地址（如"https"+"api.example.com:443"），否则 302 会跳回网关自身 -
req.URL.Path要用strings.TrimPrefix(req.URL.Path, route.Prefix)显式截断，不能靠后端自己解析 —— 否则/api/v1/users直接发过去，后端只认/users -
req.Header.Set("X-Real-IP", clientIP(req))，其中clientIP得优先取X-Forwarded-For最左非私有 IP，fallback 到req.RemoteAddr；直接信RemoteAddr在 Nginx 反代后就是网关地址
路由匹配必须预加载到内存，别现场查
生产网关的路由决策必须是 O(1) 或 O(log n)，不能遍历 slice、不能查外部存储。每次请求都走 etcd 或 DB，等于给网关装减速带。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
- 用
sync.Map存前缀映射（key 是/api/v1，value 是 *url.URL），更新时原子替换整个 map，避免读写锁竞争 - 匹配逻辑用最左最长前缀（比如
/api/v1/users应该命中/api/v1/users而不是/api），别用正则或模糊匹配做主路由 - 路径截断必须和配置里的
strip_prefix字段严格一致，strings.TrimPrefix(r.URL.Path, "/api/v1")和strings.TrimPrefix(r.URL.Path, "/api/v1/")效果完全不同
转发前必须清理 hop-by-hop 头，否则后端可能拒收
HTTP 协议规定某些 header（如 Connection、Keep-Alive、Proxy-Authenticate）不能透传，但 httputil.ReverseProxy 默认不清理，得手动干掉。
- 在
Director之后、实际转发前加一段清理逻辑：for _, h := range []string{"Connection", "Keep-Alive", "Proxy-Authenticate", "Te", "Trailers", "Transfer-Encoding", "Upgrade"} { req.Header.Del(h) } - 漏掉
Connection会导致某些后端（尤其是 Java Spring Cloud Gateway）直接返回 400 - 别依赖
http.DefaultTransport：必须自定义http.Transport，设MaxIdleConnsPerHost = 100、IdleConnTimeout = 30 * time.Second，否则默认值 2 会迅速打满后端连接
真正卡性能的从来不是路由匹配算法，而是 Director 里那几行字符串操作有没有写错、header 清没清干净、transport 连接池配没配对——这些细节错一个，上线后就是 404、502、超时雪崩轮着来。
