Go 1.27 net/http/httptest.NewRequest 的请求目标怎么验：URL、Host 与 TLS 状态

给一个 Go Handler 补测试时，最容易出现的误判是：看到请求的 URL，就顺手从 req.URL.Host 取域名，再拿它和线上 Host 断言。httptest.NewRequest 构造的是“传给服务端 Handler 的请求”，路径目标、绝对 URL、HTTPS 和请求体会分别落到不同字段里。先把这些字段的来源验清楚，测试才不会因为客户端请求和服务端请求语义混用而失真。

测试 Handler 时，先按请求目标类型选择断言：路径目标重点看 req.URL.Path 与 req.Host，绝对 URL 再核对主机名，HTTPS 只通过非空 req.TLS 判断，不能把所有信息都塞进 req.URL。

先复现一次 Host 断言为什么会错

假设路由处理器只允许 api.example.test，测试先写成下面这样：

func handler(w http.ResponseWriter, r *http.Request) {
    if r.Host != "api.example.test" {
        http.Error(w, "bad host", http.StatusBadRequest)
        return
    }
    w.WriteHeader(http.StatusNoContent)
}

func TestHandler(t *testing.T) {
    req := httptest.NewRequest("GET", "/health", nil)
    rec := httptest.NewRecorder()

    handler(rec, req)

    if rec.Code != http.StatusNoContent {
        t.Fatalf("status = %d, want %d", rec.Code, http.StatusNoContent)
    }
}

这段测试的失败不是 Handler 一定有问题，而是测试没有给服务端请求设置它要验证的 Host。默认路径目标的 Host 是 example.com，不是业务域名；同时，/health 也不是一个带主机名的绝对 URL。这里先记录“请求目标”与“Host”的关系，再决定是改测试输入，还是改 Handler 的约束。

路径目标和绝对 URL 要分两组检查

NewRequest 接受 RFC 7230 意义上的 request-target。传入 /health 这类路径时，req.URL.Path 是 /health，req.Host 使用默认的 example.com。传入 https://api.example.test/health?full=1 时，URL 中的主机名会成为请求的 Host，路径和查询参数仍然由 req.URL 保存。

func TestNewRequestTarget(t *testing.T) {
    pathReq := httptest.NewRequest("", "/health?full=1", nil)
    if pathReq.Method != http.MethodGet {
        t.Fatalf("path method = %q, want GET", pathReq.Method)
    }
    if pathReq.URL.Path != "/health" || pathReq.URL.RawQuery != "full=1" {
        t.Fatalf("path URL = %s, want /health?full=1", pathReq.URL.String())
    }
    if pathReq.Host != "example.com" {
        t.Fatalf("path Host = %q, want example.com", pathReq.Host)
    }

    absoluteReq := httptest.NewRequest("GET", "https://api.example.test/health?full=1", nil)
    if absoluteReq.Host != "api.example.test" {
        t.Fatalf("absolute Host = %q, want api.example.test", absoluteReq.Host)
    }
    if absoluteReq.URL.Path != "/health" || absoluteReq.URL.RawQuery != "full=1" {
        t.Fatalf("absolute URL = %s, want /health?full=1", absoluteReq.URL.String())
    }
}

测试业务 Host 时，直接把绝对 URL 作为输入通常更直观；如果 Handler 还要处理带端口的 Host，另加一组显式边界，不要依赖默认值。需要测试路径目标时，则在构造后设置 req.Host，这样能把“请求目标形态”和“业务 Host 校验”拆开。

HTTPS 只改变 TLS 状态，不等于真实连接

目标字符串使用 https 时，NewRequest 会把 req.TLS 设置为非空的哑 tls.ConnectionState。这对 Handler 中“仅 HTTPS 才允许”的分支很有用，但它没有启动监听器，也没有做证书校验。不要把这个请求拿去验证客户端握手、证书链或 HTTP/2 协商。

func requireHTTPS(w http.ResponseWriter, r *http.Request) {
    if r.TLS == nil {
        http.Error(w, "https required", http.StatusUpgradeRequired)
        return
    }
    w.WriteHeader(http.StatusNoContent)
}

func TestRequireHTTPS(t *testing.T) {
    for _, tc := range []struct {
        name   string
        target string
        want   int
    }{
        {name: "http", target: "http://api.example.test/health", want: http.StatusUpgradeRequired},
        {name: "https", target: "https://api.example.test/health", want: http.StatusNoContent},
    } {
        t.Run(tc.name, func(t *testing.T) {
            req := httptest.NewRequest("GET", tc.target, nil)
            rec := httptest.NewRecorder()
            requireHTTPS(rec, req)
            if rec.Code != tc.want {
                t.Fatalf("status = %d, want %d", rec.Code, tc.want)
            }
        })
    }
}

请求体类型决定 ContentLength 是否可直接断言

构造请求体时，bytes.NewReader、strings.NewReader 和 bytes.NewBuffer 的长度是已知的，NewRequest 会把它写入 ContentLength。如果传入普通的 io.Reader，就不要在测试里假定长度一定可知。http.NoBody 则明确表示没有请求体。

func TestRequestBodyLength(t *testing.T) {
    body := bytes.NewBufferString(`{"name":"go"}`)
    req := httptest.NewRequest("POST", "/profiles", body)

    if req.ContentLength != int64(body.Len()) {
        t.Fatalf("ContentLength = %d, want %d", req.ContentLength, body.Len())
    }
    if req.Body == nil {
        t.Fatal("Body is nil")
    }
}

func TestNoBody(t *testing.T) {
    req := httptest.NewRequest("POST", "/profiles", http.NoBody)
    if req.ContentLength != 0 {
        t.Fatalf("ContentLength = %d, want 0", req.ContentLength)
    }
}

这里的断言只验证 Handler 依赖的输入事实：请求体存在与否、长度是否已知。不要把 ContentLength 当成接收端一定会读到的字节数；实际读取仍应通过 r.Body.Read 或解码器完成。

把服务端请求和客户端请求放在不同测试层

如果目标是直接调用 Handler，httptest.NewRequest 是合适的入口；如果目标是验证客户端如何构造请求、重定向和传输层行为，应使用 http.NewRequest 配合 httptest.NewServer 或 Go 1.27 的 httptest.NewTestServer。两组测试可以覆盖同一个接口，但断言对象不同：前者看 Handler 收到的字段，后者看客户端真正发出的请求和响应。

这个分层也能避免一个常见的假绿：直接把 req.URL.Host 写进服务端逻辑，测试恰好用了绝对 URL，于是所有测试都通过；一旦真实请求来自反向代理或路径目标，Host 的来源就不再符合假设。

提交前用四组样本反向验证

1. 路径目标：断言 URL.Path、RawQuery、默认 Host 和空 method 转为 GET。
2. 绝对 URL：分别验证主机名进入 req.Host，路径和查询仍在 req.URL。
3. 协议状态：用 http 与 https 两个目标覆盖 req.TLS == nil 与非空分支。
4. 请求体：用 bytes.Buffer 和 http.NoBody 复核 ContentLength 与 Body 的契约。

如果测试还涉及证书、真实连接复用、HTTP/2 或客户端重试，就到 httptest.NewServer、NewTLSServer 或 NewTestServer 那一层，不要继续堆叠 NewRequest 的字段断言。

相关问题

为什么路径目标的 Host 是 example.com？

因为它模拟的是没有绝对主机名的服务端 request-target，标准库为这个场景填入默认 Host。业务需要其他 Host 时，在构造后显式设置 req.Host 或改用绝对 URL。

可以用 NewRequest 测试 TLS 证书吗？

不可以。它只设置非空的 TLS 哑状态，适合覆盖 Handler 的协议分支；证书和握手应使用 TLS 测试服务器与客户端。

为什么普通 io.Reader 的 ContentLength 不能随便写死？

因为读取器可能不提供可预知长度。只有标准库能识别的几类有界读取器和 http.NoBody 才有明确的长度语义。

把断言写在请求字段真正的归属处

httptest.NewRequest 的价值不在于替测试者填好所有业务字段，而在于用服务端语义构造一个可控输入。路径、Host、TLS 和请求体长度各自有明确来源；把断言放回对应字段，再把真实网络行为交给测试服务器，Handler 测试会更小，也更不容易因为“看起来像 URL”的字段而误判。