go网关请求路由转发核心是path匹配、director改写、modifyresponse修正三者闭环：httprouter用/api/user/*action捕获子路径，director须重写req.url.path（trimprefix）、req.host及x-real-ip，modifyresponse需处理content-length和location重写，errorhandler须结构化捕获连接、超时、tls等错误。
Go 网关做请求路由转发，核心不是“写个转发函数”，而是把 path 匹配、Director 改写、ModifyResponse 修正三者串成闭环。漏掉任一环，就可能发错请求、丢 Header、或返回 404/502。
如何用 httprouter + httputil.NewSingleHostReverseProxy 做前缀路由匹配
很多新手直接用 http.ServeMux，但它不支持通配符路径（如 /api/user/*），导致无法剥离前缀。必须换能处理路径参数的路由器。
-
httprouter是最轻量且稳定的选择：它原生支持*action这类后缀捕获，且性能优于gorilla/mux - 注册路由时，路径必须带通配符，比如
router.GET("/api/user/*action", userHandler)，否则*action不会被解析 - 在 handler 中用
params.ByName("action")拿到截断后的子路径（如请求/api/user/profile→action = "/profile"） - 别在 handler 里手动拼 URL；应把
action传给 proxy 实例的Director函数统一处理
Director 函数里必须重写哪些字段
Director 是代理行为的控制中枢，只改 req.URL.Host 和 req.URL.Scheme 不够——原始请求的 Path 和 Host 头若不处理，后端大概率收不到预期路径或拒绝连接。
- 必须显式调用
strings.TrimPrefix(req.URL.Path, "/api/user")，再赋值给req.URL.Path；否则整个原始路径（含前缀）会透传过去 - 必须设置
req.Host = backendURL.Host，否则某些后端（如 Nginx 或 Spring Boot）依赖 Host 判断租户或路由 - 建议加
req.Header.Set("X-Real-IP", clientIP(req))，其中clientIP要从X-Forwarded-For或RemoteAddr安全提取，不能直接信RemoteAddr - 不要在
Director里修改req.Body—— 它可能已被读取过，后续proxy会 panic
为什么 ModifyResponse 不只是加 Header
看似只是响应头操作，实则关系到客户端能否正确解析内容。默认情况下，httputil 会保留后端的 Content-Length，但若你在 ModifyResponse 中修改了响应体（比如注入 JSON 字段），这个长度就失效了，浏览器可能卡住或截断响应。
- 若只加 Header（如
X-Powered-By），可放心设resp.Header.Set(...) - 若需改响应体（如注入 trace-id），必须清空
Content-Length：resp.Header.Del("Content-Length")，并确保resp.ContentLength = -1 - 务必检查
resp.StatusCode：比如后端返回 302 重定向，其Location头仍是内网地址，必须用strings.Replace替换为公网域名 - 不要在
ModifyResponse中调用resp.Body.Close()——ReverseProxy自己会关
ErrorHandler 不设就会崩，但设错也白搭
没设 ErrorHandler 时，后端连不上、超时、TLS 握手失败，都会触发 panic，整个网关进程退出。设了但逻辑不对，又可能掩盖真实错误。
- 必须捕获所有常见错误类型：
*url.Error（DNS 失败）、*net.OpError（连接拒绝/超时）、*tls.AlertError（证书问题） - 不要直接
log.Printf就完事；建议结构化记录：log.Error("proxy.error", zap.String("backend", backendURL.String()), zap.Error(err)) - 返回 HTTP 状态码要区分场景：连接级失败用
http.StatusServiceUnavailable，超时用http.StatusGatewayTimeout - 注意：这个函数里
rw已部分写出，不能再调用http.Error多次，否则会报http: multiple response.WriteHeader calls
真正难的不是写通一条路由，而是每条规则都要考虑路径截断是否彻底、Header 是否污染下游、错误是否被静默吞掉。尤其当多个路由共用一个 ReverseProxy 实例时，Director 函数里对 req.URL.Path 的修改会相互干扰——这时候就得按 route 实例化 proxy，而不是全局复用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
