Go httptest用 NewRequest 构造带 Host 的请求的断言方法

在 Go 的 handler 测试里，如果路由逻辑依赖虚拟主机或租户域名，最稳妥的做法是直接把主机名写进 httptest.NewRequest 的绝对目标，例如 http://tenant.example.test/orders。这样生成的服务端请求会带有可断言的 Request.Host；不要只调用 req.Header.Set("Host", ...)，因为服务端请求的 Host 是独立字段。

官方地址：https://pkg.go.dev/net/http/httptest。下面只讨论 NewRequest 的请求构造与断言边界，不扩展到 Web 框架选型。

NewRequest 的 Host 取值规则决定了断言对象

httptest.NewRequest 创建的是适合传给 http.Handler 的服务端请求。目标参数使用绝对 URL 时，URL 中的主机名会进入请求的 Host；使用相对路径时，测试请求会采用默认主机。对虚拟主机路由来说，绝对 URL 能让测试意图直接写在构造语句里。

一个按 Host 分流的 handler 可以这样测试：

func tenantHandler(w http.ResponseWriter, r *http.Request) {
	// 中文注释：服务端路由读取 Request.Host，而不是把 Host 当普通 Header 查询。
	if r.Host != "tenant.example.test" {
		http.Error(w, "unknown host", http.StatusNotFound)
		return
	}
	w.WriteHeader(http.StatusNoContent)
}

func TestTenantHost(t *testing.T) {
	// 中文注释：绝对 URL 的主机名用于构造服务端请求的 Host。
	req := httptest.NewRequest(http.MethodGet, "http://tenant.example.test/orders", nil)
	rec := httptest.NewRecorder()

	tenantHandler(rec, req)
	if req.Host != "tenant.example.test" {
		t.Fatalf("unexpected host: %q", req.Host)
	}
	if req.URL.Path != "/orders" {
		t.Fatalf("unexpected path: %q", req.URL.Path)
	}
	if rec.Code != http.StatusNoContent {
		t.Fatalf("unexpected status: %d", rec.Code)
	}
}

旧写法的问题：Header 中的 Host 不是 Request.Host

HTTP 请求进入服务端 handler 后，Host 会被提升到 Request.Host，不再作为普通 Header map 的常规字段使用。因此下面这种写法容易造成“看起来设置成功，路由仍然不匹配”的测试：

req := httptest.NewRequest(http.MethodGet, "/orders", nil)
// 中文注释：这只修改普通 Header map，不替代服务端请求的 Request.Host。
req.Header.Set("Host", "tenant.example.test")

// 中文注释：需要改变 handler 看到的主机时，直接设置 Request.Host。
req.Host = "tenant.example.test"

更推荐优先使用绝对目标，让 Host 和 URL 在同一处表达。如果测试故意覆盖多个 Host，直接赋值 req.Host 也可以，但应在测试名称或表格数据里说明这是服务端请求字段，而不是客户端发送 Header 的模拟。

把请求构造、处理器和断言拆开

一个容易维护的测试应把三件事分开：构造输入时确定 Host 与路径，调用 handler 时只传请求和 recorder，断言时分别检查输入字段与响应结果。这样失败信息能告诉你是主机路由错了、路径错了，还是 handler 返回状态不符合预期。

表驱动测试可以把 Host 和路径放在同一组数据里：

tests := []struct {
	name string
	host string
	path string
	want int
}{
	{name: "tenant", host: "tenant.example.test", path: "/orders", want: http.StatusNoContent},
	{name: "unknown", host: "other.example.test", path: "/orders", want: http.StatusNotFound},
}

for _, tc := range tests {
	// 中文注释：每个用例独立创建请求，避免上一个 Host 影响下一个用例。
	t.Run(tc.name, func(t *testing.T) {
		req := httptest.NewRequest(http.MethodGet, tc.path, nil)
		req.Host = tc.host
		rec := httptest.NewRecorder()

		tenantHandler(rec, req)
		if rec.Code != tc.want {
			t.Fatalf("host=%q path=%q status=%d want=%d", tc.host, tc.path, rec.Code, tc.want)
		}
	})
}

兼容边界与检查清单

相对路径的默认主机适合不关心域名的测试，但不适合验证按 Host 分流的逻辑。需要端口时把端口写进绝对 URL 或 req.Host，并按实际格式断言。空方法会按 GET 处理；NewRequest 面向服务端 handler，如果要测试客户端发出的请求，应使用 http.NewRequest，不要混淆两套语义。

发布前可以快速检查四项：Host 是否写在目标 URL 或 Request.Host；路径是否与路由断言一致；handler 是否使用了同一个 recorder；状态码失败信息是否同时打印 Host 和路径。做到这四点，Host 路由测试通常不会再被普通 Header 的误用干扰。

相关问题

为什么相对路径测试总是得到默认 Host？

因为相对目标没有主机部分，httptest.NewRequest 会使用文档规定的默认主机。需要特定域名时改用绝对 URL，或在构造后设置 req.Host。

能不能用 Header.Get("Host") 断言主机名？

不建议。服务端请求的 Host 是 Request.Host 字段，测试路由时应直接断言它；普通 Header map 不是等价入口。

什么时候应该改用 http.NewRequest？

当测试目标是客户端请求的 URL、请求头写出或 Transport 行为时使用 http.NewRequest。把请求直接交给 handler 时，httptest.NewRequest 更贴合服务端测试语义。