必须重写req.url.path和req.host，否则90%的404和鉴权失败不可避免；req.url.path需用strings.trimprefix截断网关前缀，req.host须显式设为后端fqdn以确保host头正确，且必须配置errorhandler防止panic崩溃。
别在框架选型上反复纠结——Go微服务网关的路由转发能力，90%取决于你对 httputil.NewSingleHostReverseProxy 的用法是否正确，而不是用 chi 还是 gorilla/mux。
Director 里必须重写 req.URL.Path 和 req.Host
不改这两项，绝大多数 404 和后端鉴权失败就注定发生。后端服务只认真实路径（比如 /users），但客户端请求的是带网关前缀的路径（比如 /api/v1/users）；而 req.URL.Host 只影响 URL 字符串，HTTP 请求头里的 Host 字段仍为原始值，很多服务靠它做多租户路由或 TLS SNI 匹配。
-
req.URL.Path = strings.TrimPrefix(req.URL.Path, "/api/v1")：前缀必须和路由注册时完全一致，多一个斜杠、大小写错一位都会截断失败 -
req.Host = "user-service.default.svc.cluster.local"：这是真正发出去的 Host 头，不是req.URL.Host，二者无自动同步 - 如果后端是 Kubernetes Service，务必用 FQDN，别用 IP 或 short name，否则 DNS 解析可能失败
ErrorHandler 不设就会 panic 崩溃
httputil.NewSingleHostReverseProxy 默认把底层网络错误（DNS 失败、连接拒绝、TLS 握手超时）原样抛出，不捕获就触发 goroutine panic，整个 HTTP server 退出——这不是 bug，是设计如此。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 必须显式设置
proxy.ErrorHandler，且不能只打日志，要调用http.Error()或手动写 status + body，否则 client 会卡在 pending 状态 -
net/http.ErrServerClosed是服务关闭信号，不是上游错误，不该进ErrorHandler，需在顶层http.Server.Shutdown()中处理 - 常见误判：把
context.DeadlineExceeded当作后端不可用，其实可能是客户端主动断开，应区分对待
别在路由层做代理，用 chi 或 gorilla/mux 只负责匹配
直接用 chi 注册 r.HandleFunc("/api/v1/users", proxyHandler) 是可行的，但真要扛住生产流量，核心不在“怎么注册路由”，而在“怎么安全兜底转发”。自研转发逻辑容易漏掉 header 透传、连接复用、超时控制等细节。
- 每个路由对应一个独立的
httputil.ReverseProxy实例，避免共享状态污染 -
ModifyResponse可用于统一加X-Powered-By、清理敏感 header，但不要在里面做耗时操作（如调用外部鉴权服务） - 中间件顺序很重要：鉴权 → 限流 → 路由匹配 → 代理转发，顺序错可能导致未授权请求被转发
真正难的不是写通转发，而是让每条路径都严格对应后端期望的 Path 和 Host，同时确保错误不穿透、连接不泄漏、header 不错乱——这些细节没压到每一行代码里，网关上线第一天就可能出问题。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
