测试 HTTP handler 应避免直接运行 main 函数，而需提取为独立函数并用 httptest.NewRequest 和 httptest.NewRecorder 进行单元测试，确保可断点、快速反馈、不依赖网络与外部服务。
测试 HTTP handler 时别直接跑 main 函数
直接 go run main.go 启动服务再手动 curl，没法断点、看不到请求上下文、改一次代码就得重启——这不是测试，是受罪。GoLand 的测试机制专为这种场景设计，关键在于把 handler 提取成可独立调用的函数。
常见错误：写一堆 http.HandleFunc 或在 r.GET 里塞匿名函数，导致逻辑无法被单元测试覆盖。
- 把路由处理逻辑抽成普通函数，接收
*http.Request和http.ResponseWriter，返回 error 或 void - 避免在 handler 内部直接调用
log.Fatal、os.Exit等终止进程的操作 - 用
httptest.NewRequest和httptest.NewRecorder构造请求/响应，完全脱离网络栈
用 httptest 快速验证 handler 行为
Go 标准库的 httptest 包就是干这个的：不启端口、不占资源、秒级反馈。你写的每个 handler 都该有对应测试，而不是等集成环境暴露问题。
示例片段（不用框架）：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
func TestMyHandler(t *testing.T) {
req := httptest.NewRequest("GET", "/api/user?id=123", nil)
rr := httptest.NewRecorder()
MyHandler(rr, req) // 直接调用，非启动 server
if status := rr.Code; status != http.StatusOK {
t.Errorf("handler returned wrong status code: got %v want %v",
status, http.StatusOK)
}
if rr.Body.String() == "" {
t.Error("expected non-empty response body")
}
}
-
httptest.NewRequest支持设置 Header、Body、URL Query、Method，覆盖绝大多数真实请求场景 -
rr.Body.String()可直接断言 JSON 输出；若返回结构体，用json.Unmarshal解析后比对字段 - 测试中不要依赖外部服务（如数据库、Redis），用 interface + mock 替换，否则不是单元测试
Gin/Echo 等框架的测试写法差异
框架封装了 http.Handler，但测试方式本质一致——只是初始化方式不同。别被 gin.Testing() 这类方法名迷惑，它只是帮你预设了测试用的 Engine 实例。
- Gin：用
gin.SetMode(gin.TestMode)关闭日志干扰，再调用engine.ServeHTTP(rr, req) - Echo：需手动创建
echo.New()，然后e.ServeHTTP(rr, req) - 不要在测试里写
engine.Run(":8080")——这会阻塞线程且无法断点调试
注意：Gin 的 c.ShouldBindJSON 在测试中可能因 Body 未 rewind 失败，务必在构造 req 后调用 req.Body = io.NopCloser(bytes.NewReader(data))。
调试失败的网络请求时，先看 recorder.Body 和 Status Code
测试失败时，90% 的问题出在三处：状态码不对、响应体为空、JSON 解析 panic。GoLand 的测试窗口能直接展开 rr.Body.Bytes() 和 rr.Header()，比翻日志快得多。
- 如果
rr.Code == 0，说明 handler 没调用WriteHeader或 panic 了，检查 defer/recover 是否吞掉错误 - 如果
rr.Body.String()是空字符串但状态码是 200，大概率是 handler 忘了Write或写了空 struct - 用鼠标悬停查看
rr.Result().StatusCode，比硬编码rr.Code更安全（后者不包含重定向跳转后的最终状态）
真正的难点不在写测试，而在让 handler 本身足够“瘦”——剥离业务逻辑、依赖注入、中间件解耦。否则测试永远卡在“怎么 mock auth middleware”上。
