Golang中基于函数路由实现的微型API网关设计-Golang-PHP中文网

director必须重写，否则裸转发导致路径错乱、host头错误、x-forwarded-for缺失、重定向url异常；需显式设置req.url.scheme、req.url.host、req.host，用trimprefix截前缀并规范路径，选gin路由，调优transport连接池与超时，透传真实客户端ip。

golang中基于函数路由实现的微型api网关设计

httputil.NewSingleHostReverseProxy 的 Director 必须重写

不重写 Director 就等于裸转发，90% 的生产问题都从这里开始：路径错乱、Host 头仍是网关自身、X-Forwarded-For 缺失、重定向 URL 变成 http://localhost。默认行为只改 req.URL.Host，其余一概不管。

必须显式设置三项：

req.URL.Scheme = proxyURL.Scheme（别信 proxyURL.String()，Scheme 可能被忽略）
req.URL.Host = proxyURL.Host
req.Host = proxyURL.Host（强制覆盖 Host 头，下游服务靠它做租户识别或 CORS 判断）

路径处理要小心：strings.TrimPrefix(req.URL.Path, "/api/v1") 是常见写法，但得先 path.Clean 规范路径，再补上开头的 /，否则 /api/v1//users 会变成 //users 导致 404。

用 gin 而非 http.ServeMux 做路由分发

http.ServeMux 会自动裁剪前缀，比如注册 /user/*，转发时 req.URL.Path 已被截成 /v1/profile，下游服务收不到完整路径。这不是 bug，是设计使然——但它不适合网关。

gin 更适合入口层，原因很实际：

c.Param("id") 类型安全，不用手动从 map[string]string 里取值再转类型
c.AbortWithStatus(401) 能明确中断中间件链，鉴权失败后限流、日志都不再执行
默认禁用 debug 模式，上线不易手抖

示例路由写法：r.Any("/order/*path", proxyHandler("order-svc:8080"))，其中 *path 会完整保留到 c.Param("path")，供 Director 手动拼接。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

Transport 必须调优，否则网关就是故障放大器

用默认 http.DefaultTransport 上线，等于把网关交给随机性：DNS 缓存永久生效、空闲连接不释放、整请求卡死在 30 秒、大文件上传直接 OOM。

关键字段必须设：

DialContext 套 &net.Dialer{Timeout: 5 * time.Second, KeepAlive: 30 * time.Second}
IdleConnTimeout: 30 * time.Second（和下游 HTTP server 的 keep-alive timeout 对齐）
MaxIdleConnsPerHost: 100（防文件描述符耗尽）
Timeout: 8 * time.Second（比下游 P99 高 2 秒即可）

别碰 TLSClientConfig.InsecureSkipVerify，那是测试用的，上线配置里必须删掉。