Go-Zero HTTP API端到端测试需绕过网络调用、复用handler逻辑，推荐用httptest.NewRecorder构造请求并断言响应；测试路径参数需匹配API定义格式；完整链路测试需通过rest.Server.ServeHTTP触发中间件。
准备测试环境与依赖注入
要在 Go-Zero 项目中对 HTTP API 进行真实请求路径的端到端验证，必须绕过网络调用、复用已有 handler 逻辑，同时确保路由参数、中间件、绑定解析等行为与生产一致——这要求测试代码能直接驱动内部 HTTP 处理链，而非启动真实服务。
首先确认项目已启用 go-zero 的标准测试结构：每个 API 路由对应一个 handler 函数，该函数接收 *http.Request 和 http.ResponseWriter；所有 handler 都注册在 routes.go 中，并由 server.ServeHTTP 统一调度。
测试前需禁用日志输出干扰，避免 t.Log 污染断言判断：在测试函数开头插入 logx.Disable() 或使用 logtest.Discard(t)。
【必须重置全局配置或 serviceContext，否则测试间状态污染会导致随机失败】
用 httptest.NewRecorder 测试单个 handler（推荐）
这是最轻量、最稳定、覆盖度最高的方式，适用于 95% 的单元测试场景。它不监听端口、不启动 goroutine、完全内存内执行，且能精确断言响应状态码、Header、JSON Body。
第一步：用 http.NewRequest 构造原始请求，注意手动设置 URL.Path 和 URL.RawQuery —— 否则 chi/gorilla/mux 等路由器无法识别路径参数（如 /user/{id}）。
第二步：调用 httptest.NewRecorder() 创建响应记录器，它实现了 http.ResponseWriter 接口，所有 WriteHeader/Write 调用都会被捕获到内存缓冲区中。
第三步：将请求和记录器传入目标 handler 函数，例如 handler.GetUser(ctx, req, rr)。注意：不要调用 ListenAndServe 或 server.ServeHTTP，那会引入网络栈和并发竞争。
第四步：检查 rr.Code 是否等于预期状态码，rr.Body.String() 是否包含正确 JSON，以及 rr.Header().Get("Content-Type") 是否为 application/json。若 handler 内部调用了 ctx.AbortWithStatusJSON，则需确保错误处理分支也被覆盖。
模拟带路径参数和查询参数的请求
Go-Zero 默认使用 go-zero/core/httpx 解析请求，它依赖标准 http.Request 结构，但对路径参数的提取依赖于路由框架（如 go-zero 自带 router 或 chi）。若你未替换默认 router，可直接用以下方式构造：
方法一：纯 net/http 路由（无第三方框架）
直接设置 req.URL.Path = "/user/123"，req.URL.RawQuery = "page=1&size=10"，然后调用 handler.ServeHTTP(rr, req)。
方法二：使用 go-zero 内置 router 测试辅助（推荐）
go-zero 提供了 httpx.Parse 工具函数，它会自动从 req.URL.Path 中提取路径参数并注入到 context 中。你只需保证 req.URL.Path 格式与 api 文件中定义的路由完全一致，例如 api 文件写的是 GET /user/:id，那么 req.URL.Path 就必须是 /user/123，不能是 /user?id=123。
注意：若 api 定义中使用了 path:"id" tag（如 type GetUserReq { Id int64 `path:"id"` }），则 handler 内部会通过 httpx.Parse(r, &req) 自动填充，此时你无需手动解析，但必须确保 req.URL.Path 匹配路由模板，否则 Parse 会返回 error 并返回 400。
测试含中间件的完整请求链路
Go-Zero 的中间件（如 JWT 验证、CORS、限流）通常包装在 handler 外层，注册于 routes.go 的 AddRoute 调用中。要测完整链路，不能只调 handler 函数，而应调用封装后的路由函数。
步骤一：在 internal/handler/routes.go 中找到类似 server.AddRoute(rest.Route{Method: http.MethodGet, Path: "/user/:id", Handler: getUserHandler}) 的注册语句。
步骤二：新建一个临时 *rest.Server 实例（来自 github.com/zeromicro/go-zero/rest），调用其 ServeHTTP 方法：srv := rest.MustNewServer(rest.RestConf{}) → srv.AddRoute(...) → srv.ServeHTTP(rr, req)。
步骤三：此时中间件会按注册顺序执行。若中间件依赖 config 或 svc.Context，需在测试前构造好 serviceContext 并注入到 handler 中——常见做法是把 handler 改为接收 *svc.ServiceContext 的闭包，测试时传入 mock context。
这一步操作起来很简单，直接把文件拖进去就行。
