Go httputil.ReverseProxy需在Director中显式设置req.Host和req.Header["Host"]，并清理hop-by-hop头、添加X-Forwarded-For等；多路由时应为各实例定制Director，或改用Oxy Forward简化处理。
Go 的 httputil.ReverseProxy 默认不改请求头，必须手动在 Director 函数里操作 req.Header，否则后端收不到你想要的 Host、X-Forwarded-For 等关键字段。
Director 中修改请求头必须显式赋值，不能只改 req.Host
很多人以为设置 req.Host = "backend.example.com" 就够了，其实这只是改了请求行里的 Host 字符串，req.Header["Host"] 仍是原始值。后端（尤其是 Nginx、Spring Boot）通常优先读取 Header 中的 Host，导致 404 或路由错乱。
- 必须同时设置：
req.Host = "backend.example.com"和req.Header.Set("Host", "backend.example.com") - 添加转发标识：
req.Header.Set("X-Forwarded-For", realIP)（需先从req.RemoteAddr或X-Real-IP解析真实 IP） - 清理 hop-by-hop 头：
for _, h := range hopHeaders { req.Header.Del(h) }，其中hopHeaders = []string{"Connection", "Keep-Alive", "Proxy-Authenticate", "Proxy-Authorization", "Te", "Trailers", "Transfer-Encoding", "Upgrade"} - 若后端依赖
X-Forwarded-Prefix生成跳转链接，记得补上：req.Header.Set("X-Forwarded-Prefix", "/api/v1")
多个路由规则下，Header 重写逻辑要随目标动态变化
当用前缀查表方式分发请求（如 /admin → admin-svc、/user → user-svc），不同后端对 Header 的要求可能不同：admin-svc 要求 X-Admin-Token，user-svc 要求 X-User-Context。硬编码在全局 Director 里会冲突。
- 推荐把 Header 修改逻辑封装进每个
*httputil.ReverseProxy实例的Director闭包里，而非统一处理 - 例如：
proxyAdmin.Director = func(req *http.Request) { ... req.Header.Set("X-Admin-Token", token) ... } - 避免复用同一
req.Header引用：如果用了req.Clone()，新请求的 Header 是独立副本，可安全修改 - 注意并发安全：
req.Header本身不是线程安全的，但每个请求生命周期内只被单个 goroutine 操作，无需额外加锁
用 Oxy Forward 替代原生 ReverseProxy 可省去大部分手动 Header 处理
如果你不需要极致轻量或想快速上线，Oxy Forward 提供了声明式 Header 重写能力，比手写 Director 更少出错。
立即学习“go语言免费学习笔记（深入）”；
- 添加/覆盖 Header：
forward.WithRequestHeaders(map[string]string{"X-Env": "prod", "X-Forwarded-Proto": "https"}) - 删除 Header：
forward.WithoutRequestHeaders("Cookie", "Authorization") - 条件化设置（比如只对 POST 加头）：
forward.WithRequestHeadersFunc(func(r *http.Request) map[string]string { if r.Method == "POST" { return map[string]string{"X-Post-Only": "true"} } return nil }) - 它内部已自动处理 hop-by-hop 头清理和
Host同步，不用再自己写Del循环
真正容易被忽略的是：Header 修改必须发生在 Director 执行期间，且不能晚于 proxy.ServeHTTP 调用——一旦进入转发流程，req.Header 就会被底层 Transport 序列化发送，后续修改无效。另外，X-Forwarded-For 若未做 IP 校验（比如信任了伪造的 X-Real-IP），会带来日志污染甚至安全绕过风险。
