应优先用 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.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)
}

注意点：

• 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 解析失败却以为是业务逻辑问题。