使用 httptest 创建测试服务器，通过 http.Client 发送请求并校验状态码、响应头和结构化 JSON 数据，需覆盖正常流程与错误场景，如参数缺失、认证失败等，确保 API 稳定性和健壮性。
在Go语言开发中，API测试是确保服务稳定性和正确性的关键环节。通过编写可重复执行的测试用例，可以有效验证HTTP接口的行为是否符合预期。下面介绍如何使用Golang标准库和一些常用实践来测试API请求与响应。
使用 net/http/httptest 模拟HTTP服务
Go内置的 net/http/httptest 包允许你创建一个临时的HTTP服务器用于测试，无需真正启动端口监听的服务。
你可以将实际的路由处理器传入 httptest.NewServer，然后向这个测试服务器发起请求，验证响应内容。
- 创建测试服务器：用 httptest.NewServer(handler) 封装你的路由逻辑
- 使用 http.Client 向该服务器发送GET、POST等请求
- 检查返回状态码、响应头、响应体是否符合预期
示例代码：
立即学习“go语言免费学习笔记（深入）”；
func TestAPISuccess(t *testing.T) {
handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"message": "ok"}`))
})
server := httptest.NewServer(handler)
defer server.Close()
resp, err := http.Get(server.URL)
if err != nil {
t.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("期望状态码200，实际得到 %d", resp.StatusCode)
}
var data map[string]string
json.NewDecoder(resp.Body).Decode(&data)
if data["message"] != "ok" {
t.Errorf("期望消息为 ok，实际为 %s", data["message"])
}
}
测试结构化响应数据
大多数API返回JSON格式数据。为了准确校验响应内容，建议定义对应的结构体，并使用 encoding/json 解码后做字段比对。
避免直接字符串匹配，因为JSON顺序或空格可能影响结果。结构化解析更可靠。
- 定义与API响应匹配的Go结构体（可用匿名结构体简化）
- 使用 json.Unmarshal 或 json.NewDecoder 解析响应体
- 逐字段断言值的正确性，尤其是关键业务字段
例如：
type Response struct {
Status string `json:"status"`
Data struct {
ID int `json:"id"`
Name string `json:"name"`
} `json:"data"`
}
// 在测试中：
var result Response
json.NewDecoder(resp.Body).Decode(&result)
if result.Status != "success" {
t.Errorf("状态应为 success")
}
if result.Data.ID != 123 {
t.Errorf("ID 不符")
}
测试错误路径与边界情况
除了正常流程，必须覆盖常见的错误场景，比如参数缺失、非法输入、认证失败等。
通过构造异常请求，确认API能返回合适的错误码和提示信息。
- 发送缺少必要参数的请求，验证是否返回400 Bad Request
- 模拟未授权访问，检查是否返回401或403
- 故意触发内部错误（如数据库查询失败），验证是否安全降级并返回500
这类测试帮助发现潜在漏洞，提升系统健壮性。
集成测试真实客户端调用
如果你的应用提供的是对外API，也可以写一个“客户端”封装，然后在测试中调用这个客户端方法，观察其行为。
这种模式更适合端到端验证整个调用链路。
- 构建轻量客户端函数，封装HTTP请求细节
- 在测试中调用这些函数，验证返回结果和错误处理
- 可结合 testify/assert 等库让断言更简洁
这种方式便于后期迁移为真实服务调用，也利于文档生成和复用。
基本上就这些。Golang的标准库已经足够支撑高质量的API测试，关键是设计清晰的用例，覆盖正向和反向逻辑。不复杂但容易忽略的是细节校验和错误处理测试。
