应优先用 httptest.NewServer 启动临时服务器并走完整 HTTP 生命周期测试接口，避免绕过路由和中间件；需校验 Content-Type、关闭 resp.Body、用结构体反序列化 JSON 并逐字段断言，推荐 testify/assert 提升可读性。
用 http.NewRequest 和 httptest.NewServer 构造真实请求场景
直接调用 handler 函数（如 handler.ServeHTTP）虽快，但绕过了路由、中间件、请求解析等环节，容易漏掉 header 解析失败、body 未读取、content-type 不匹配等问题。真实验证接口返回值，应优先走完整 HTTP 生命周期。
推荐方式是启动一个临时测试服务器：
server := httptest.NewServer(http.HandlerFunc(yourHandler)) defer server.Close()再用标准
http.Client 发起请求。这样能捕获 Content-Type 错误、重定向跳转、gzip 响应解压异常等真实链路问题。
常见疏漏点：
-
http.NewRequest第二个参数必须是完整 URL（如"http://localhost:8080/api/user"），不能只写路径，否则client.Do会 panic - POST 请求记得设置
req.Header.Set("Content-Type", "application/json")，否则某些 handler 会因未识别类型而返回 415 - 务必调用
resp.Body.Close()，否则 goroutine 泄露，go test -race会报错
用 json.Unmarshal + 类型断言验证结构化响应体
不要用字符串包含（strings.Contains）或正则去断言 JSON 字段——字段顺序、空格、浮点数精度都会导致误判。正确做法是定义预期结构体，反序列化后逐字段比较。
示例：
var respBody struct {
Code int `json:"code"`
Msg string `json:"msg"`
Data struct {
ID int `json:"id"`
Name string `json:"name"`
} `json:"data"`
}
err := json.Unmarshal(respBytes, &respBody)
if err != nil {
t.Fatal(err)
}
if respBody.Code != 200 {
t.Errorf("expected code 200, got %d", respBody.Code)
}
注意点：
立即学习“go语言免费学习笔记（深入）”；
- JSON tag 名必须与响应字段完全一致（包括大小写），
json:"user_id"对应"user_id"，不是"userId" - 如果响应字段可能为空或缺失，字段类型建议用指针（如
*string）或加omitempty，避免零值覆盖判断 - 嵌套结构太深时，可先用
map[string]interface{}快速提取关键字段，但仅限调试，正式断言仍需结构体
用 testify/assert 替代原生 t.Error 提升可读性
原生 t.Errorf 在失败时只输出一行，字段多时难以定位哪一环出错。testify/assert 的 assert.Equal、assert.JSONEq 等函数会自动高亮 diff，且支持链式断言。
例如：
assert.Equal(t, 200, resp.StatusCode)
assert.JSONEq(t, `{"code":200,"msg":"ok"}`, string(respBytes))
关键优势：
-
assert.JSONEq忽略字段顺序和空白符，比assert.Equal更适合 JSON 断言 - 所有断言失败后测试继续执行（非 fatal），能一次性看到多个错误，适合批量验证
- 但注意：它不支持自定义错误消息，若需上下文（如 “用户创建后状态码应为 201，但得到 500”），仍要用
t.Errorf
处理非 JSON 接口：检查 resp.Header.Get("Content-Type") 再选解析方式
很多接口返回纯文本（text/plain）、XML（application/xml）或二进制（image/png）。硬套 json.Unmarshal 会导致 panic 或静默失败。
务必先检查响应头：
contentType := resp.Header.Get("Content-Type")
if !strings.HasPrefix(contentType, "application/json") {
t.Fatalf("unexpected Content-Type: %s", contentType)
}
其他常见类型处理方式：
- XML：用
xml.Unmarshal，结构体 tag 写xml:"field_name" - 纯文本：用
io.ReadAll(resp.Body)得到[]byte，再用strings.TrimSpace和assert.Equal - 二进制：用
bytes.Equal校验固定内容，或用image.Decode解析后验证尺寸/格式
最容易被忽略的是：没校验 Content-Type 就直接解析，结果服务端返回了 HTML 错误页（比如 500 时返回了 gin 默认的 HTML 错误模板），JSON 解析失败却以为是业务逻辑问题。
