必须重写Director函数，否则90%请求失败；需显式设置req.URL.Scheme、req.URL.Host、req.Host，用TrimPrefix剥离路径前缀，设X-Real-IP，删hop-by-hop头，并调优Transport连接池与超时。
直接用 httputil.NewSingleHostReverseProxy 启动网关，不重写 Director 函数，90% 的请求会失败——路径错乱、Host 头丢失、WebSocket 断连、真实 IP 无法透传，全是默认行为惹的祸。
必须重写的 Director 函数怎么写
这个函数不是可选项，是网关转发逻辑的唯一入口。它只做一件事：把原始请求改写成后端能正确接收的样子。任何鉴权、限流、日志都该放在它之外。
- 显式设置
req.URL.Scheme和req.URL.Host，否则 HTTPS 请求可能连到 HTTP 后端，触发 301 跳转 -
req.Host必须设为上游地址，不能留空或沿用网关 Host；下游服务靠它做租户识别、CORS 或生成绝对 URL - 路径前缀要用
strings.TrimPrefix(req.URL.Path, "/api/v1")手动剥离，别依赖路由库自动裁剪——gorilla/mux的PathPrefix会吃掉路径，http.ServeMux根本不保留原始路径 - 加
req.Header.Set("X-Real-IP", getClientIP(req))，getClientIP要从X-Forwarded-For最左非私有 IP 提取，不能直接用req.RemoteAddr - 删掉 hop-by-hop header：
req.Header.Del("Connection")、req.Header.Del("Keep-Alive")、req.Header.Del("Proxy-Authenticate")，否则可能引发循环代理或协议错误
Transport 不调优，网关就是故障放大器
默认 http.DefaultTransport 在微服务场景下完全不可控：DNS 缓存永久生效、空闲连接不释放、大文件上传 OOM、建连卡死 30 秒——这不是性能差，是根本没法运维。
-
DialContext设超时：建议5 * time.Second，避免建连阻塞整个请求链 -
IdleConnTimeout设为30 * time.Second，需与后端 keep-alive timeout 对齐，防止僵死连接占满文件描述符 -
MaxIdleConnsPerHost至少设100，高并发下不设此值会导致连接池无限增长，最终too many open files - 线上环境禁用
TLSClientConfig.InsecureSkipVerify: true，这是测试配置，上线前必须删掉
路由层选 chi 或 gorilla/mux，别碰 http.ServeMux
http.ServeMux 没有路径参数、不支持子路由隔离、自动裁剪前缀且无法关闭——当你配 /user/* 转发到 user-svc，下游收到的是 / 而不是 /user/profile，重定向 URL 直接崩成 http://localhost/。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
chi的router.Mount("/v1/users", userRouter)会自动剥离前缀，userRouter内部只需处理/users/{id}段，不用再切一次/v1 -
gorilla/mux的r.PathPrefix("/users").Handler(proxy)显式控制路径拼接，比硬编码http.HandleFunc更可控 - 所有路由最后统一接
http.HandlerFunc(proxyHandler)，转发逻辑收口，避免每个 handler 重复初始化httputil.NewSingleHostReverseProxy - 路径变量务必加正则约束，比如
{id:[0-9]+}，防正则回溯炸 CPU
为什么别在网关里自己实现限流和熔断
单机 rate.Limiter 在分布式流量下毫无意义；sony/gobreaker 熔断器无法感知其他节点失败率——你写的“限流”只是给单实例画个圈，集群里其他网关照样放行超量请求。
- 限流必须中心化：用 Redis 实现令牌桶共享状态，或接入 Istio/Envoy 的服务网格能力
- 熔断需跨实例协同：gobreaker 只适合单服务内部保护，网关级熔断应由服务发现组件（如 Consul）健康检查驱动
- JWT 鉴权可以做，但密钥轮换、黑名单管理、OAuth2 授权码流程支持成本极高，不如交给专用认证服务
- 错误响应必须统一：所有出错都返回标准 JSON 格式
{"code":500,"message":"upstream timeout"}，禁止暴露下游堆栈或原始错误细节
真正容易被忽略的点是：网关不是业务服务，它的核心价值在于稳定转发——所有中间件都得围绕“不拖慢、不丢请求、不错传头”来设计。一旦在 Director 里加 DB 查询或 HTTP 调用，整个链路就失去可观测性和可预测性。
