在 go 单元测试中，需构造 *http.request 对象来模拟真实入站请求；关键在于正确初始化 body 字段（如使用 io.nopcloser 包装空读取器），并注意 get 请求默认无请求体的语义约束。
在 go 单元测试中，需构造 *http.request 对象来模拟真实入站请求；关键在于正确初始化 body 字段（如使用 io.nopcloser 包装空读取器），并注意 get 请求默认无请求体的语义约束。
在 Go 的 net/http 包中，*http.Request 类型在服务端（如 http.Handler 接收的请求）与客户端（如 http.NewRequest 创建的请求）场景下行为一致，但构造方式和字段初始化要求存在关键差异：服务端请求的 Body 字段绝不能为 nil（即使为空），否则在调用 req.Body.Read() 或中间件（如 httputil.DumpRequest）时会 panic；而客户端请求若未显式设置 Body，某些方法（如 GET）可能自然保持 nil —— 这正是测试中容易出错的地方。
✅ 正确创建可测试的服务端请求
使用 http.NewRequest 是起点，但必须确保 Body 非 nil。推荐方式是用 io.NopCloser 包装一个空读取器（如 strings.NewReader("") 或 bytes.NewReader(nil)）：
package main
import (
"bytes"
"io"
"net/http"
"testing"
)
func TestMyHandler(t *testing.T) {
// ✅ 正确：Body 非 nil，支持多次读取（需 Resettable）
body := io.NopCloser(bytes.NewReader([]byte(`{"name":"test"}`)))
req, err := http.NewRequest("POST", "/api/user", body)
if err != nil {
t.Fatal(err)
}
// 可选：设置常见 Header
req.Header.Set("Content-Type", "application/json")
req.Header.Set("User-Agent", "test-client/1.0")
// ✅ 现在可安全传入 Handler
// handler.ServeHTTP(rr, req)
}
⚠️ 注意事项与最佳实践
- GET 请求无 Body 是规范行为：HTTP/1.1 标准未禁止 GET 携带 body，但绝大多数服务端框架（包括 Go net/http）不解析、也不依赖它。测试 GET 逻辑时，Body 可设为 nil 或 io.NopCloser(strings.NewReader(""))，但应避免业务逻辑依赖 GET body。
- Body 只能读取一次：req.Body 是流式接口。若 Handler 内部已读取（如 json.Decode(req.Body)），后续再读将返回 io.EOF。测试中如需多次检查，可用 httptest.NewRequest（自动处理 Body 重置）或手动 req.Body = io.NopCloser(bytes.NewReader(...)) 重建。
-
更简洁的替代方案：httptest.NewRequest
标准库 net/http/httptest 提供了专为测试优化的构造函数，自动处理 Body 初始化，并支持 FormValue、MultipartReader 等高级特性：req := httptest.NewRequest("PUT", "/users/123", strings.NewReader(`{"age":30}`)) req.Header.Set("Authorization", "Bearer xyz")
✅ 总结
在 Go 单元测试中模拟 HTTP 服务器请求，核心原则是：始终确保 req.Body != nil。优先使用 httptest.NewRequest（最安全、最符合测试语义），其次使用 http.NewRequest + io.NopCloser 显式包装读取器。避免直接传递 nil body，尤其在涉及中间件、日志、鉴权等依赖 req.Body 的场景中——这是保障测试稳定性和贴近生产行为的关键。
