直接用net/http+httputil.NewSingleHostReverseProxy搭最轻量路由网关足够用；gorilla/mux或chi仅是路由器，不提供Director、ModifyResponse、ErrorHandler等代理核心控制点，徒增复杂度且易漏错误处理。
直接用 net/http + httputil.NewSingleHostReverseProxy 搭最轻量的路由网关，够用且无额外依赖；别一上来就套 Gin/Echo 或 gorilla/mux，它们只加复杂度，不解决核心转发问题。
为什么不用 gorilla/mux 或 chi 做基础路由层
gorilla/mux 和 chi 本质是 HTTP 路由器，不是反向代理实现。它们不自带 Director、ModifyResponse、ErrorHandler 这些关键控制点，你仍得手动拼 httputil.NewSingleHostReverseProxy，再 wrap 成 handler——等于多套一层壳，还容易漏掉错误处理。
- 硬编码路由：改一条路径就得重启，不支持运行时增删
- 无健康检查：后端挂了照样转发，客户端收到 502/504 都不知道源头在哪
- 中间件必须手动链式调用：比如忘了在鉴权后
return，后续逻辑照常执行，权限形同虚设 -
req.URL.Path不截断前缀，请求原样发给后端（如/api/v1/users→ 后端只认/users），必 404
怎么写一个真正可用的 httputil.NewSingleHostReverseProxy 实例
关键不在“创建 proxy”，而在三处重写：请求地址、响应头、错误捕获。下面是最小生产可用模板：
func NewReverseProxy(backendURL *url.URL) *httputil.ReverseProxy {
proxy := httputil.NewSingleHostReverseProxy(backendURL)
proxy.Director = func(req *http.Request) {
req.URL.Scheme = backendURL.Scheme
req.URL.Host = backendURL.Host
// 必须截断前缀，否则后端收不到正确路径
req.URL.Path = strings.TrimPrefix(req.URL.Path, "/api")
// Host header 必须显式设置，否则后端可能拒收
req.Host = backendURL.Host
// 透传原始客户端 IP
if clientIP := getClientIP(req); clientIP != "" {
req.Header.Set("X-Forwarded-For", clientIP)
}
}
proxy.ModifyResponse = func(resp *http.Response) error {
resp.Header.Set("X-Powered-By", "go-gateway")
return nil
}
proxy.ErrorHandler = func(rw http.ResponseWriter, req *http.Request, err error) {
log.Printf("proxy error to %s: %v", backendURL, err)
http.Error(rw, "upstream failed", http.StatusServiceUnavailable)
}
return proxy
}
-
proxy.ErrorHandler不设会 panic：连接超时或后端拒绝时整个进程崩溃 -
req.Host和req.URL.Host是两回事：前者影响 header 发送，后者影响实际连接目标 - 所有后端地址必须用具体 IP:Port（如
10.10.1.5:8081），别用localhost或order-srv——容器里 DNS 不一定通，也不跨 namespace
如何让单个 Go 文件支持多后端路由
用标准库 http.ServeMux 就够，不需要框架。它支持前缀匹配，且可嵌套 handler，干净可控：
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
func main() {
mux := http.NewServeMux()
<pre class="brush:php;toolbar:false;">// /user/* → user-srv
userProxy := NewReverseProxy(&url.URL{Scheme: "http", Host: "10.10.1.2:8081"})
mux.Handle("/user/", http.StripPrefix("/user", userProxy))
// /order/* → order-srv
orderProxy := NewReverseProxy(&url.URL{Scheme: "http", Host: "10.10.1.3:8082"})
mux.Handle("/order/", http.StripPrefix("/order", orderProxy))
log.Println("gateway listening on :8000")
log.Fatal(http.ListenAndServe(":8000", mux))}
-
http.StripPrefix必须加：否则/user/api/v1/create会被原样发到后端，而它只认/api/v1/create - 每个
NewReverseProxy实例应复用http.Transport：自定义proxy.Transport可设连接超时、keep-alive、TLS 握手时间，避免默认值太松 - 不要在
Director里做 DB 查询或 HTTP 调用：那是同步阻塞操作，会卡住整个 goroutine，拖垮并发能力
真正难的不是“怎么转”，而是“转错时怎么快速定位”——比如后端返回 404，你要能立刻区分是路径没截对、Host 头被拒、还是 upstream 根本没收到请求。日志里至少得带 req.URL.Path、req.Host、upstream_addr 和响应状态码，少一个字段都可能多花半小时排查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
