go 1.21+ 可用标准库构建轻量网关，但需避免 http.servemux 路径截断和 gin 耦合问题；应选用 gorilla/mux 或 chi 做路由层，配合 httputil.newsinglehostreverseproxy 实现干净转发，并严格配置超时、连接池与 director。
Go 1.21+ 已能直接用 net/http 和标准库写轻量网关，不需要额外框架——但盲目套用 http.ServeMux 或直接上 gin 容易在路由匹配、中间件顺序、超时控制上翻车。
确认 Go 版本并启用 module 模式
微服务网关对依赖隔离和版本锁定敏感，go mod 不是可选项。低于 go1.16 默认关闭 module，会误读 vendor 或全局 $GOPATH，导致 go run 报 no required module provides package。
- 运行
go version，确保输出含go1.21或更高 - 执行
go env -w GO111MODULE=on（Windows 用go env -w GO111MODULE=on） - 新建目录后立即运行
go mod init gateway.example，模块名不用真实域名，但需符合包导入路径规则
用 net/http 实现基础反向代理网关
httputil.NewSingleHostReverseProxy 是标准库最稳的起点，比手写 http.Transport + http.RoundTrip 少踩 80% 的连接复用和 header 透传坑。
- 必须重写
Director函数，否则默认只转发 Host 不改路径，后端收不到原始/api/v1/users - 务必设置
proxy.Transport的IdleConnTimeout和MaxIdleConnsPerHost，否则长连接堆积导致上游拒绝新连接 - 不要直接用
http.ListenAndServe(":8080", proxy)，应包装一层http.Server并设ReadTimeout/WriteTimeout，避免慢下游拖垮整个网关
proxy := httputil.NewSingleHostReverseProxy(&url.URL{Scheme: "http", Host: "localhost:9001"})
proxy.Director = func(req *http.Request) {
req.Header.Set("X-Forwarded-For", req.RemoteAddr)
req.URL.Scheme = "http"
req.URL.Host = "localhost:9001"
}
server := &http.Server{
Addr: ":8080",
Handler: proxy,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
}
添加路由分发与简单鉴权中间件
标准 http.ServeMux 不支持路径参数（如 /users/{id}）和优先级匹配，硬套会导致 /api/v1/users 被 /api 提前截断。
- 用
gorilla/mux或chi替代原生 mux，它们解析路径更准，且chi.Router自带With方法链式挂中间件 - 鉴权逻辑别写死在 handler 里，提取成函数接收
http.Handler返回新http.Handler，方便复用和单元测试 - JWT 验证若用
golang-jwt/jwt/v5，注意ParseWithClaims的func(token *jwt.Token) (interface{}, error)必须返回公钥或对称密钥，返回nil会 panic
调试时高频报错与定位点
网关日志里反复出现 http: proxy error: dial tcp [::1]:9001: connect: connection refused，不一定是后端没起——更可能是 DNS 解析失败（比如用了 host.docker.internal 但在 Linux 上未配置）或 Transport 的 DialContext 超时太短。
- 先用
curl -v http://localhost:8080/health看是否返回 502，再检查netstat -tuln | grep 9001确认后端监听地址 - 加一行
log.Printf("proxying to %s", req.URL.String())到Director，确认重写后的 URL 是否正确 - 如果用 Docker 运行网关，宿主机 localhost 在容器内不可达，必须改用
host.docker.internal（Mac/Win）或宿主真实 IP（Linux）
真正的难点不在代码行数，而在每个中间件的执行顺序、header 的清理时机、以及超时值在 client→gateway→backend 三层间的传导关系——这些细节不会报错，但会让请求在某个环节静默卡住几秒才失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
