使用httptest进行HTTP接口测试，通过NewRequest和NewRecorder模拟请求与响应，结合表驱动测试和依赖注入实现高覆盖率的单元测试。
在Go语言开发中，HTTP接口的单元测试是保障服务稳定性和正确性的关键环节。通过编写可靠的测试用例并合理使用模拟请求技术，可以有效验证API行为、提升代码质量。下面介绍如何对Golang中的HTTP接口进行单元测试与模拟请求的实践方法。
使用net/http/httptest进行接口测试
Go标准库提供的httptest包专为HTTP处理程序的测试设计，能够创建临时的HTTP服务器或直接调用Handler，无需启动真实端口。
常见做法是将业务逻辑封装在http.HandlerFunc中，然后通过httptest.NewRequest和httptest.NewRecorder构造请求与捕获响应。
- 创建一个Request对象，指定方法、路径和可选的请求体
- 使用NewRecorder接收处理结果
- 直接调用注册的Handler函数，传入Recorder和Request
- 检查返回的状态码、响应头和响应体是否符合预期
这种方式绕过网络层，执行速度快，适合覆盖各种输入边界情况。
立即学习“go语言免费学习笔记（深入）”；
模拟外部HTTP请求
当接口依赖第三方服务时，应避免在单元测试中发起真实网络请求。可通过接口抽象结合mock实现解耦。
定义一个HTTP客户端接口，例如：
type HTTPClient interface {
Get(url string) (*http.Response, error)
}
在生产代码中使用http.DefaultClient，测试时替换为自定义的模拟实现。
- 构造一个实现了该接口的struct，其Get方法返回预设的响应数据
- 也可使用httptest启动一个临时服务，返回固定内容
- 利用http.Client的Transport字段注入模拟RoundTripper
这样可以在不依赖外部环境的情况下测试错误处理、超时逻辑等场景。
测试JSON API的典型流程
多数现代Web服务以JSON格式通信，测试时需关注序列化与反序列化的正确性。
示例步骤：
- 构造携带JSON Body的POST请求，设置Content-Type为application/json
- 调用被测Handler
- 解析Recorder.Body中的JSON响应
- 使用reflect.DeepEqual或testify/assert对比结构体字段
注意处理时间、浮点数精度等易出错细节。建议将常用断言逻辑封装成辅助函数，提高测试可读性。
覆盖率与表驱动测试
为了全面覆盖不同输入分支，推荐使用表驱动（table-driven）方式组织测试用例。
每个用例包含输入参数、期望状态码、期望响应内容等字段，循环执行并断言。
配合go test -cover命令查看测试覆盖率，重点关注未覆盖的条件分支。
高覆盖率不能完全代表质量，但能显著降低遗漏边界情况的风险。
基本上就这些。掌握httptest和依赖注入技巧后，大多数HTTP接口都能写出稳定、快速的单元测试。关键是把可测性考虑进初始设计，比如分离路由逻辑与业务处理，避免全局变量滥用。
