API网关作为微服务统一入口，需实现路由转发、认证鉴权、限流熔断、日志监控；1. 基于 net/http/httputil.ReverseProxy 实现反向代理，动态加载配置支持多规则匹配；2. 通过中间件校验 JWT 或 API Key，注入用户上下文；3. 使用 rate.Limiter 实现令牌桶限流，结合 gobreaker 熔断防雪崩；4. 记录请求日志并暴露 Prometheus 指标，支持链路追踪；模块化设计利于扩展，配合信号监听实现配置热更新与优雅重启。
在微服务架构中，API网关作为系统的统一入口，负责请求路由、认证鉴权、限流熔断、日志监控等功能。使用Golang开发API网关，凭借其高并发、低延迟和高性能的特性，成为越来越多团队的首选方案。下面从核心功能实现角度，介绍如何用Golang构建一个实用的微服务API网关。
1. 路由转发与反向代理
API网关最基础的功能是接收外部请求，并根据配置将请求转发到对应的微服务实例。
Golang标准库中的 net/http/httputil.ReverseProxy 可以轻松实现反向代理。通过自定义 Director 函数，可以修改请求目标地址、添加头信息等。
示例代码：创建一个简单的反向代理处理器：
立即学习“go语言免费学习笔记（深入）”；
director := func(req *http.Request) {
target, _ := url.Parse("http://service-user:8080")
req.URL.Scheme = target.Scheme
req.URL.Host = target.Host
req.Header.Set("X-Forwarded-For", req.RemoteAddr)
}
proxy := &httputil.ReverseProxy{Director: director}
http.HandleFunc("/user/", func(w http.ResponseWriter, r *http.Request) {
proxy.ServeHTTP(w, r)
})
实际项目中，路由规则通常从配置中心（如etcd、Consul）动态加载，支持前缀匹配、正则匹配等多种方式。
2. 认证与权限控制
网关应统一处理身份验证，避免每个服务重复实现。
常见做法是在请求进入时校验 JWT Token 或 API Key：
- 解析并验证 JWT，提取用户身份信息
- 检查 API Key 是否合法及是否有访问该接口的权限
- 将用户上下文注入请求头（如 X-User-ID）传递给后端服务
可封装中间件实现：
func AuthMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if !verifyToken(token) {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
ctx := context.WithValue(r.Context(), "user", userID)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
3. 限流与熔断保护
防止突发流量压垮后端服务，网关需具备限流和熔断能力。
限流 可基于客户端IP或用户ID，使用令牌桶算法（如 golang.org/x/time/rate）实现：
limiter := rate.NewLimiter(10, 20) // 每秒10个，突发20个
if !limiter.Allow() {
http.Error(w, "Too Many Requests", http.StatusTooManyRequests)
return
}
熔断 可集成 sony/gobreaker 等库，在后端服务异常时快速失败，避免雪崩。
4. 日志与监控
记录请求日志有助于排查问题和分析流量。建议记录关键字段：
- 请求路径、方法、状态码
- 响应时间、客户端IP
- 用户标识、跟踪ID（用于链路追踪）
结合 Prometheus 暴露指标（如QPS、延迟、错误率），配合 Grafana 展示实时数据。
也可集成 OpenTelemetry 实现分布式链路追踪。
基本上就这些。一个轻量但完整的Go语言API网关，重点在于清晰的模块划分：路由管理、插件式中间件、动态配置加载。随着业务增长，可逐步加入SSL终止、负载均衡、灰度发布等功能。不复杂但容易忽略的是配置热更新和优雅重启，建议结合 signal 监听实现平滑升级。
