Go微服务API网关必须重写httputil.NewSingleHostReverseProxy的Director函数，否则默认裸转发会导致路径错乱、Host头错误、X-Forwarded-For缺失、跳转URL异常等生产问题；需显式设置Scheme/Host、透传真实IP、删除hop-by-hop头，并调优Transport连接池与超时。
Go 微服务 API 网关不是“另一个后端服务”，而是请求入口的可控边界——它不处理业务，但必须稳、准、快地转发，并对路由、超时、头透传、错误响应等细节有绝对掌控力。硬套框架或依赖默认行为，上线后大概率遇到 502、超时抖动、IP 伪造、路径错乱等问题。
httputil.NewSingleHostReverseProxy 的 Director 必须重写
这个函数开箱即用等于裸转发，90% 的生产问题都源于没改 Director。它默认只改 req.URL.Host，其余全留原样：路径带前缀、Host 头是网关自己的、X-Forwarded-For 没加、跳转头没删——后端服务收不到真实客户端 IP，重定向 URL 写成 http://localhost，甚至因 Host 不匹配直接 404。
- 必须显式设置
req.URL.Scheme和req.URL.Host（别信upstreamURL.String()，Scheme 可能被忽略） - 路径要手动切前缀：
req.URL.Path = strings.TrimPrefix(req.URL.Path, "/api/v1")，别用正则替换，避免/api/v1/user→/user误伤/api/v1/user-profile - 透传真实 IP：
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 缓存永久生效、空闲连接不释放、整请求卡死在 30 秒、大文件上传 OOM。这不是性能差，是根本没法运维。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
DialContext设Timeout: 5 * time.Second，建连失败快速抛出，别等默认 30 秒 -
IdleConnTimeout: 30 * time.Second，必须和下游服务的 keep-alive timeout 对齐，否则僵死连接占满 fd -
MaxIdleConnsPerHost: 100，防止高并发时耗尽文件描述符；不设的话，长连接池会无限增长 - 别碰
TLSClientConfig.InsecureSkipVerify上线环境——那是测试用的，删掉
路由层选 gin 而非 http.ServeMux 或 gorilla/mux
不是因为 gin “更高级”，而是它对网关这类入口组件更安全：中间件链可控、错误不隐式 panic、路径参数类型安全、c.AbortWithStatus() 能明确中断流程。用 http.ServeMux 会自动裁剪前缀导致路径丢失；gorilla/mux 的中间件模型松散，一个 panic 就可能让整个网关挂掉。
立即学习“go语言免费学习笔记（深入）”；
- 用
r.Group("/users")统一加鉴权/限流中间件，失败时调c.AbortWithStatus(401)，后续中间件不执行 - 路径参数用
c.Param("id")直接得string，比gorilla/mux.Vars(req)["id"]的map[string]string更安全 - 别在
Director里做鉴权或 DB 查询——那是阻塞操作，会拖慢所有请求，且无法缓存或并行 - 聚合多个服务时，每个下游调用必须绑定独立
context.WithTimeout(parentCtx, 2*time.Second)，别共用一个 context
别在 Go 里从零实现限流/熔断/中心化鉴权
这些不是胶水逻辑，而是状态敏感、需跨实例协同的模块。单机 golang.org/x/time/rate.Limiter 抗不住分布式流量；自己用 sync.Map 存 token 黑名单，扩缩容就失效；sony/gobreaker 熔断器看不到其他节点的失败率。
- 限流建议走 Redis + Lua 原子计数，或接入 Istio/Envoy 的服务网格层
- JWT 鉴权可做，但密钥轮换、
kid动态选 key、过期时间容错（±1.5 秒）必须到位；别用strings.Split手动解析 token - 熔断交给专用组件，Go 网关只做轻量 fallback 和日志标记，比如对
502/503/504返回预设降级响应 - 真正难的不是代码，是网关行为与下游服务 SLA 的对齐——比如对外超时设 8s，转发到 order-srv 时就得预留 2s buffer，否则调度延迟会误杀正常请求
