director函数是必填项，因其默认仅改req.url.host和scheme，不重写则导致后端404、重定向错乱、websocket断连、真实ip丢失；必须显式设置req.url.scheme/host、req.host、x-forwarded-for及删除hop-by-hop头。
直接用 net/http + httputil.NewSingleHostReverseProxy 就能跑通核心转发，但不重写 Director 函数，90% 的生产请求会出问题——比如后端 404、重定向地址错乱、WebSocket 断连、真实客户端 IP 丢失。
为什么 Director 函数不是可选项，而是必填项
Go 标准库的 httputil.NewSingleHostReverseProxy 默认只改 req.URL.Host 和 req.URL.Scheme，其余全靠你补全。跳过这一步，下游服务就拿不到关键上下文：
-
req.Host不显式赋值 → 后端生成的绝对 URL（如 OAuth redirect_uri）会指向网关自身，而非原始域名 - 不设置
X-Forwarded-For→ 所有日志和限流都基于网关 IP，无法按真实客户端做策略 - 不清理
Connection和Upgrade头 → WebSocket 请求直接被拒绝，返回 400 或 502 - 不重置
req.RequestURI→ 当路径含查询参数时，ReverseProxy可能拼出非法 URI，触发 panic
如何安全地重写 Director：三行核心逻辑
一个生产可用的 Director 只需聚焦三件事：修正目标地址、透传客户端标识、剥离干扰头。别在里面加鉴权或日志——那是中间件该干的活：
proxy.Director = func(req *http.Request) {
req.URL.Scheme = "http"
req.URL.Host = "user-svc:8080"
req.Host = "user-svc:8080" // 强制覆盖，避免 Host 被上游篡改
if clientIP := getClientIP(req); clientIP != "" {
req.Header.Set("X-Forwarded-For", clientIP)
}
req.Header.Set("X-Forwarded-Proto", "https") // 若网关启用了 TLS
req.Header.Del("Connection")
req.Header.Del("Keep-Alive")
}
注意：getClientIP 必须从 X-Real-IP 或可信的 X-Forwarded-For 最左端取，不能无条件信任 Header；req.URL.Path 无需手动拼接——StripPrefix 已处理好路径裁剪。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
用 http.StripPrefix 做路径路由时的两个硬约束
路径前缀匹配看似简单，但实际部署中常因两处细节翻车：
- 必须确保
http.Handle("/api/", ...)的路径末尾带斜杠，否则/api和/api/会被当成两个不同路由，后者才触发StripPrefix -
http.StripPrefix("/api/", proxy)只剥离一次前缀，若后端期望完整路径（如/api/v1/users），就不能用它——得在Director里手动还原req.URL.Path = "/api" + oldPath - 多个前缀共存时（如
/user/和/order/），不能依赖http.DefaultServeMux，必须用gorilla/mux或自定义http.ServeMux显式注册，否则路由顺序不可控
别把网关变成“瑞士军刀”：中间件该放哪、不该放哪
所有非转发逻辑（鉴权、限流、日志）必须放在 http.Handler 链上，而不是塞进 Director。否则你会遇到：
- 在
Director里调用http.Get查 token → 每个请求阻塞数秒，吞吐暴跌 - 在
Director里写日志 → 日志时间戳晚于响应发出，监控指标错位 - 在
Director里改req.Header做 A/B 测试 → 无法统一管理 header 注入策略
正确做法是包装 handler：http.Handle("/user/", authMiddleware(limitMiddleware(proxyHandler)))。每个中间件只做一件事，且必须支持 context 取消——网关超时应立刻终止下游调用，而不是等它自己结束。
最易被忽略的点：Transport 层的连接池配置。默认 http.Transport 的 MaxIdleConnsPerHost 是 2，高并发下会频繁建连，CPU 和 TIME_WAIT 暴涨。上线前务必显式设置 MaxIdleConnsPerHost: 100 和 IdleConnTimeout: 30 * time.Second。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
