Golang微服务流量镜像测试方法

Go微服务中用httputil.NewSingleHostReverseProxy实现流量镜像，需提前读取并重放req.Body、克隆请求、显式设置URL.Host、配置超时；相比Istio，自实现可保证body完整性、支持条件过滤、可观测性强且适配本地开发。

Go 微服务里怎么用 httputil.NewSingleHostReverseProxy 做流量镜像

流量镜像不是转发，也不是重试，是「原样复制一份请求发到另一个地址，主链路完全不受影响」。最轻量、可控性最强的做法，就是自己写一个中间件，用 httputil.NewSingleHostReverseProxy 拉起一个镜像代理，把请求 body 和 header 完整透传过去。

关键点在于：必须提前读取并重放 req.Body，否则主链路或镜像链路会因 body 已被消费而收不到数据；同时要克隆 *http.Request，避免 header 修改污染主请求。

• 用 io.ReadAll(req.Body) 一次性读完原始 body，再用 bytes.NewReader() 分别塞给主 handler 和镜像 proxy
• 调用 req.Clone(req.Context()) 创建镜像请求，否则修改 Host 或 Header 会影响主流程
• 镜像请求的 URL.Host 必须显式设为目标镜像地址，NewSingleHostReverseProxy 不会自动覆盖
• 务必设置超时（比如用 &http.Client{Timeout: 3 * time.Second}），镜像失败绝不能拖慢主响应

为什么不用 Istio 的 mirroring 而选 Go 自实现

因为 Istio 的流量镜像默认只镜像 HTTP/1.1 的 header + path + method，不保证 body 完整性（尤其 chunked 或流式 body），且镜像失败时可能静默丢弃——这对测试下游服务行为（比如日志、告警、异步处理）不可接受。

自实现能控制粒度：比如只镜像特定 path（/api/v1/order）、跳过含敏感字段的请求（检查 req.Header.Get("X-Auth-Type") == "internal"）、甚至对镜像请求加 X-Mirror-Source: order-svc 标识。

• Istio 镜像发生在 Envoy 层，Go 服务无法感知镜像是否成功，也拿不到镜像返回结果
• 自实现可记录镜像耗时、HTTP 状态码、错误类型（如 connection refused），用于监控告警
• 本地开发联调时，Istio 环境往往不存在，而 Go 层镜像开关可由配置项 MIRROR_ENABLE=true 控制，启动即生效

io.Copy 直接转发 body 会导致主请求收不到数据？

会。HTTP 请求 body 是 io.ReadCloser，底层可能是 socket 连接或内存 buffer，一旦被 io.Copy 或 io.ReadAll 消费一次，再次读就返回 EOF。主 handler（比如 Gin 的 c.ShouldBindJSON(&order)）会直接解析失败，报 invalid character '}' after top-level value 或空 struct。

• 正确做法：用 bodyBytes, _ := io.ReadAll(req.Body) 读一次，然后分别构造两个 io.ReadCloser：io.NopCloser(bytes.NewReader(bodyBytes))
• 千万别用 req.Body = ioutil.NopCloser(bytes.NewReader(bodyBytes)) 后直接交给主 handler——这会改掉原始 req.Body，后续中间件也会受影响
• 如果请求 body 很大（>1MB），考虑加 size limit 或改用临时文件，避免 OOM；但测试场景通常小流量，内存读取更简单可靠

镜像请求发出去了，但目标服务收不到或返回 404

大概率是 Host 头或路径没对齐。Go 的 httputil.NewSingleHostReverseProxy 默认保留原始 req.Host，而目标镜像服务（比如本地 localhost:8081）可能依赖 Host 判断租户或路由，也可能只认 /v1/mirror/... 这类带前缀的路径。

• 必须手动设置镜像请求的 req.URL.Host = "mirror-svc.default.svc.cluster.local:80"（K8s）或 "localhost:8081"（本地）
• 用 req.Header.Set("Host", "mirror.example.com") 覆盖 Host 头，别依赖原始值
• 如果镜像服务要求路径前缀，用 req.URL.Path = "/v1/mirror" + req.URL.Path 拼接，注意避免双斜杠
• 用 curl -v 或 Wireshark 抓包确认发出的请求长什么样，比猜快得多

真正难的不是发出去，而是确保镜像请求和原始请求在语义上等价——body 内容、header 大小写、编码方式、甚至时钟偏差（比如 X-Request-Time）都可能让下游行为不一致。这些细节不打日志，根本没法 debug。