Golang怎么做API网关_Golang API网关教程【总结】-Golang-PHP中文网

最简路由转发应先用 net/http 原生能力硬编码转发，避免过早引入中间件或高级路由库；必须显式透传 host 头、自定义 transport 和 errorhandler，并手动安全重写路径；健康检查与熔断需按上游服务单独实现。

golang怎么做api网关_golang api网关教程【总结】

用 `net/http` 做最简路由转发，别一上来就写中间件链

Go 写 API 网关，最容易掉进“架构幻觉”：还没跑通一个请求，就在设计插件系统、配置热加载、JWT 解析中间件。实际第一步只是让 http.ServeMux 或 http.HandlerFunc 把请求原样转给后端服务。

先硬编码一个 http.Post 或 http.DefaultTransport.RoundTrip 调用目标服务，确认能通；不要碰 gorilla/mux 或 gin —— 它们自带路由语义，会模糊你对“转发”本质的理解
注意 Host 头必须显式透传：req.Host = upstreamHost，否则 Nginx 或云厂商 LB 可能 404
别用 httputil.NewSingleHostReverseProxy 开局——它默认不透传 X-Forwarded-For，也不处理 Upgrade header（WebSocket 就断）

`httputil.NewSingleHostReverseProxy` 的三个必改字段

这个函数看着省事，但开箱即用会出生产事故。它只改了 Director，其余关键行为全靠默认值扛，而默认值在网关场景下基本都不对。

Director 里必须重设 req.URL.Scheme 和 req.URL.Host，否则 HTTPS 后端收到 HTTP URL 会 301 跳转
Transport 必须自定义：默认的 http.DefaultTransport 没设 MaxIdleConnsPerHost，长连接池会耗尽，表现为间歇性超时
ErrorHandler 必须重写：默认直接 write string 错误，前端收不到标准 JSON error body，前端工程师会半夜打电话

示例关键片段：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

proxy := httputil.NewSingleHostReverseProxy(upstreamURL)
proxy.Transport = &http.Transport{
    MaxIdleConnsPerHost: 100,
    TLSClientConfig:     &tls.Config{InsecureSkipVerify: true},
}
proxy.ErrorHandler = func(rw http.ResponseWriter, req *http.Request, err error) {
    rw.Header().Set("Content-Type", "application/json")
    rw.WriteHeader(http.StatusBadGateway)
    json.NewEncoder(rw).Encode(map[string]string{"error": "upstream failed"})
}

路径重写用 `req.URL.Path` 手动切，别信正则替换库

网关常要 /api/v1/users → /users，看似简单，但 strings.Replace 或第三方 path rewrite 库会在边界 case 翻车：比如 /api/v1/user → /user，结果把 /api/v1/user-profile 也错改成 /user-profile。