httputil.NewSingleHostReverseProxy 是首选，因其为Go官方维护、自动处理hop-by-hop头过滤、重定向重写等关键逻辑；需通过Director重写URL和Host、显式设置X-Forwarded-For，CONNECT方法须hijack处理，Body读取后须重建并设ContentLength，Transport需独立配置超时与连接池。
用 httputil.NewSingleHostReverseProxy 做基础转发
Echo 本身不内置反向代理能力，必须靠 Go 标准库的 httputil.ReverseProxy 实现。最常用的是 httputil.NewSingleHostReverseProxy，它接受一个 *url.URL，返回一个实现了 http.Handler 的代理实例。这个实例能直接被 echo.WrapHandler() 包装后注册进路由。
关键点在于：路径匹配必须带通配符 /*，否则子路径（比如 /users/123 或 /users?sort=desc）不会被转发。示例中写 e.Any("/users/*", echo.WrapHandler(proxy)) 是必须的，写成 /users 或 /users/ 都会失败。
常见错误现象：
- 请求
/users/123返回 404，但/users能通 → 路径没加/* - 后端收不到原始查询参数或 body → 没调用
proxy.Transport或Director修正请求 - 后端返回 400，提示 Host 头非法 →
NewSingleHostReverseProxy默认把Host改成上游地址，需重写
必须重写 Director 才能保留原始 Host 和 Header
Director 是 ReverseProxy 的核心钩子函数，用于修改即将发给上游的 *http.Request。默认行为会把 req.Host 设为上游 URL 的 Host，同时清空部分 X-Forwarded-* 头。如果你的后端依赖原始 Host、X-Real-IP 或自定义 header（比如鉴权 token），不改 Director 就会出问题。
正确做法是手动复制关键字段：
- 保留原始
req.Host：直接赋值outReq.Host = req.Host - 补全
X-Forwarded-For：用req.Header.Get("X-Forwarded-For") + ", " + clientIP（需先从req.RemoteAddr提取 IP） - 透传自定义 header：比如
outReq.Header.Set("X-Request-ID", req.Header.Get("X-Request-ID")) - 修正
RequestURI：避免路径重复拼接，通常设为req.URL.RequestURI()
示例片段：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
proxy.Director = func(req *http.Request) {
req.URL.Scheme = "http"
req.URL.Host = usersURL.Host
req.Host = req.Header.Get("Host") // 保留原始 Host
if clientIP := strings.Split(req.RemoteAddr, ":")[0]; clientIP != "" {
if fwd := req.Header.Get("X-Forwarded-For"); fwd != "" {
req.Header.Set("X-Forwarded-For", fwd+", "+clientIP)
} else {
req.Header.Set("X-Forwarded-For", clientIP)
}
}
}
e.Any("/path/*", ...) 和 e.Group("/path").Any("/*", ...) 效果一样吗
效果相同，但语义和维护性不同。e.Any("/path/*", ...) 是直写路径，适合简单网关；e.Group("/path").Any("/*", ...) 把前缀提取出来，后续所有路由自动继承，更利于扩展中间件（比如统一加鉴权或日志）。
注意两点：
-
Group的路径末尾不能带/，写成e.Group("/users/")会导致实际匹配变成/users//xxx，多出一个斜杠 -
Group内注册的Any("/*", ...)中的*是必须的，只写"*"或"/"都不匹配子路径 - 如果多个 Group 路径有重叠（比如
/api/v1和/api），Echo 按注册顺序匹配，先注册的优先 —— 这点容易被忽略，建议按最长前缀优先原则组织注册顺序
转发时 body 读取失败或超时怎么处理
标准 ReverseProxy 在读取 request body 时会一次性读完并重放，但如果客户端发送流式 body（如大文件上传）或超时中断，可能触发 http: read on closed response body 或 i/o timeout 错误。
解决方法：
- 设置
proxy.Transport的IdleConnTimeout和TLSHandshakeTimeout，避免连接复用过久失效 - 对大 body 显式限制长度：在代理前加中间件，用
c.Request().Body做io.LimitReader，超过阈值直接返回 413 - 禁用 body 缓存（仅限不需要重放的场景）：在
Director中设req.Body = nil并清除Content-Length，但这样后端就收不到 body 了 - 生产环境务必配置
Timeout和KeepAlive，否则长连接堆积会耗尽文件描述符
最常被忽略的是：没有为 ReverseProxy 单独配置 Transport，而是复用默认的 http.DefaultTransport，导致连接池参数（如 MaxIdleConnsPerHost）不合理，小流量没事，一上量就卡死。
