Go不提供开箱即用API网关，需基于gin+httputil.ReverseProxy构建轻量反向代理网关，但限流/熔断/鉴权等应交由Envoy等专用组件实现。
Go 本身不提供开箱即用的“API 网关”组件，net/http 和 gorilla/mux 或 gin-gonic/gin 只是 HTTP 路由器，不是网关。真要构建生产级微服务 API 网关，得自己补全路由分发、鉴权、限流、熔断、日志、可观测性等能力——或者直接用成熟方案。
用 gin + gorilla/handlers 快速搭个轻量网关原型
适合内部工具链、POC 或流量不大且规则简单的场景。核心是把网关变成“反向代理路由器”，不处理业务逻辑，只做转发和基础中间件。
-
gin.Engine负责定义入口路由（如/user/*、/order/*） - 每个路由绑定一个
httputil.NewSingleHostReverseProxy实例，指向下游服务地址（如http://user-svc:8080） - 用
gorilla/handlers.CORS、handlers.Compress、handlers.ProxyHeaders做通用中间件 - 注意：原生
httputil.ReverseProxy不自动重写Host和X-Forwarded-*头，需手动设置Director函数
func newDirector(upstream string) func(*http.Request) {
return func(req *http.Request) {
req.URL.Scheme = "http"
req.URL.Host = upstream
req.Header.Set("X-Forwarded-Host", req.Host)
req.Header.Set("X-Forwarded-For", getClientIP(req))
}
}
r := gin.Default()
r.Use(gin.Recovery())
r.Any("/user/*path", proxyHandler("user-svc:8080"))
r.Any("/order/*path", proxyHandler("order-svc:8080"))
func proxyHandler(upstream string) gin.HandlerFunc {
proxy := httputil.NewSingleHostReverseProxy(&url.URL{Scheme: "http", Host: upstream})
proxy.Director = newDirector(upstream)
return func(c *gin.Context) {
proxy.ServeHTTP(c.Writer, c.Request)
}
}
为什么别在 Go 里从零实现限流/熔断/鉴权？
这些不是胶水逻辑，而是状态敏感、时序关键、需跨实例协同的模块。自己用 golang.org/x/time/rate 做单机令牌桶，扛不住分布式流量；用 sony/gobreaker 做熔断，无法感知其他节点的失败率。
- 限流：需要中心化存储（Redis）或服务网格（Istio 的 Envoy）配合，否则各网关实例各自为政
- 鉴权：JWT 校验可以做，但密钥轮换、黑名单管理、OAuth2 授权码流程支持成本高
- 熔断：依赖实时错误率统计，单进程内存无法反映全局健康度
- 真实项目中，这些能力通常下沉到 Kubernetes Ingress Controller（如 Nginx Ingress + OpenResty）、Service Mesh（Istio + Envoy）或专用网关（Kong、Tyk）
当必须用 Go 写网关时，优先集成 go-control-plane 对接 Envoy
这是云原生场景下更可持续的选择：Go 进程只负责生成和推送 xDS 配置（路由、集群、监听器），真正的流量转发、TLS 终止、gRPC 透传、可观测性均由 Envoy 承担。
立即学习“go语言免费学习笔记（深入）”；
- 用
github.com/envoyproxy/go-control-plane实现EndpointDiscoveryServiceServer和RouteDiscoveryServiceServer - 下游服务注册信息从 Consul/Etcd/Nacos 拉取，动态生成
ClusterLoadAssignment - JWT 验证交给 Envoy 的
envoy.filters.http.jwt_authn，Go 层只管配置下发 - 避免重复造轮子，也规避 Go runtime 在高并发长连接下的 GC 和调度瓶颈
真正难的不是把请求转给 user-svc，而是当 10 个服务、30 种认证方式、每秒 5000 次限流策略变更时，还能保持配置一致、故障隔离、指标可查。这时候 Go 代码越少，系统越稳。
