Director必须重写，否则请求原样转发导致404/502/跳转错乱；需显式设置req.URL.Scheme、req.URL.Host、req.Host，截断路径前缀，透传X-Real-IP，删除hop-by-hop头，并调优Transport连接池与超时。
httputil.NewSingleHostReverseProxy 的 Director 必须重写
不重写 Director 函数，就等于把请求原封不动甩给后端——路径带前缀、Host 头是网关自己的、X-Forwarded-For 缺失、重定向 URL 变成 http://localhost，上线后 404 / 502 / 跳转错乱全是它惹的祸。
典型修正逻辑如下：
-
req.URL.Scheme = "http"或"https"，别依赖upstreamURL.String()，它可能忽略 Scheme -
req.URL.Host = upstream.Host，同时显式设req.Host = upstream.Host，否则下游 CORS 或租户识别会失败 -
req.URL.Path = strings.TrimPrefix(req.URL.Path, "/api/v1")，用TrimPrefix，别用正则替换，避免/api/v1/user-profile被误切为/user-profile -
req.Header.Set("X-Real-IP", getClientIP(req))，getClientIP要从X-Forwarded-For最左非私有 IP 提取，不能直接用req.RemoteAddr -
req.Header.Del("Connection")、req.Header.Del("Keep-Alive")、req.Header.Del("Proxy-Authenticate")，防止 hop-by-hop 头引发循环或协议错误
路由层选 chi 而非 http.ServeMux 或 gorilla/mux
http.ServeMux 会自动裁剪路径前缀，导致下游收不到完整路径；gorilla/mux 中间件模型松散，一个 panic 就可能让整个网关挂掉；而 chi 的中间件链可控、c.AbortWithStatus() 能明确中断流程、路径参数类型安全，更适合网关这种“入口即边界”的场景。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 用
r.Group("/users")统一加鉴权/限流中间件，失败时调c.AbortWithStatus(401)，后续中间件不执行 - 避免在
chi.Router().Route("/user", ...)里硬编码转发逻辑，这违背网关解耦原则 - 路由匹配后，再调用自定义
httputil.NewSingleHostReverseProxy，不要让路由层承担代理职责
Transport 连接池与超时必须手动调优
默认的 http.DefaultTransport 在微服务网关场景下完全不可控：DNS 缓存永久生效、空闲连接不释放、整请求卡死在 30 秒、大文件上传 OOM。这不是性能差，是根本没法运维。
关键配置项：
-
MaxIdleConns: 100，防文件描述符耗尽 -
MaxIdleConnsPerHost: 100，避免单 host 占满连接池 -
IdleConnTimeout: 30 * time.Second，及时回收空闲连接 -
TLSClientConfig: &tls.Config{InsecureSkipVerify: false}，上线环境必须删掉InsecureSkipVerify: true - 为每个上游服务实例配独立
http.Transport，避免不同服务间的连接竞争和故障传播
动态路由与服务发现需绕过静态路由绑定
硬编码 chi 路由规则（如 r.Get("/user/*", proxyToUserSvc)）无法支持服务发现、健康检查或灰度发布。真正可行的是把路由决策下沉到 Director 内部，结合注册中心实时拉取节点。
例如：
- 在
Director函数中调serviceRegistry.Get(ctx, req.URL.Path)获取目标地址 - 根据
protocol字段区分"http"和"grpc"，后者应转发至配套的grpc-gateway sidecar，而非直连 gRPC Server - 负载均衡策略（轮询/一致性哈希）在
Director内完成，不依赖外部 round-tripper 封装 - 健康检查结果应缓存在本地，
Director中跳过已标记为 down 的节点，避免无效转发
最易被忽略的一点：所有路径重写、Header 注入、IP 透传都必须发生在 Director 函数内——不在这个函数里做的修改，httputil 都不会生效。
