Go httptest 请求 Host 不符合预期的测试写法

用 httptest.NewRequest 测试域名路由时，应设置 req.Host，或者把完整 URL 传给构造函数。只调用 req.Header.Set("Host", "...") 不会改变 Request.Host。若 target 只是 /status，httptest 默认使用 example.com，因此业务代码读取 Host 时不一定得到你心里预期的域名。

Go httptest 官方地址：https://pkg.go.dev/net/http/httptest

一个很容易让测试失去意义的细节是：请求里同时放着 URL、Host 字段和 Header map，名字看似相关，却不负责同一件事。我的建议是先确定测试的是 Handler 的路由判断，还是完整 HTTP 请求往返，再选择请求构造方法。下面的示例未在本文生成过程中执行；结果都是测试中明确写出的预期。

Host 路由应读取哪个字段

在 Go 的服务端请求模型中，Host 是专门的字段。HTTP 请求解析会把 Host 信息放到 Request.Host，而不是让业务处理器从普通 Header map 读取它。普通服务端请求的 URL 常常只有 Path、RawQuery 等部分，URL.Host 可能为空；用它代替 r.Host，会让测试与真实请求表现不同。

这也解释了一个不适应点：直接构造一个带绝对 URL 的服务端测试请求，URL.Host 看上去可用，容易掩盖 Handler 读取了错误字段的问题。只用这一种请求形状，并不能覆盖常见的路径形式入站请求。

只写路径时为什么会得到 example.com

httptest.NewRequest 面向服务端 Handler 测试，允许 target 是路径，也允许是绝对 URL。路径形式没有提供主机，它会填入默认 example.com；完整 URL 则提供相应主机。两种形式都不会为了构造对象而向该域名发起网络请求。

// 片段：放在测试函数中，文件需导入 net/http 与 net/http/httptest。
req := httptest.NewRequest(http.MethodGet, "/status", nil)
req.Host = "portal.example" // 显式构造服务端应看到的主机。
req.Header.Set("X-Trace-Label", "host-case")

// 另一种形式适合表达完整 URL，但不应作为唯一的入站请求形状。
absolute := httptest.NewRequest(http.MethodGet, "http://portal.example/status", nil)
_ = absolute

这里的 portal.example 是测试域名，不是产品入口。使用路径再设置 Host，能够把“请求路径”和“业务主机”作为两个独立变量表达。我更倾向于用它测试 Host 路由，再用完整 URL 补充构造行为对照，而不是让所有用例都依赖构造函数从 URL 提取主机。

不要在构造后只改 req.URL.Host，期待 Request.Host 也跟着变化。它们是两个独立字段，手工修改对象不会重新执行一次 HTTP 解析。直接给 Handler 传一个不一致的对象，可能是在测试现实中没有打算支持的输入。

用表驱动测试固定 Host 与路由结果

下面是完整的 vhost_test.go，可放进已有 Go 模块。示例业务有意只接受精确的 portal.example 与 /status，其他主机返回 404；这是一条具体业务策略，不是 Go 自动规定所有域名必须精确区分端口或大小写。

package vhost

import (
    "net/http"
    "net/http/httptest"
    "testing"
)

// 示例策略只读取专用 Host 与路径，不读取 Header 中的 Host。
func hostHandler(w http.ResponseWriter, r *http.Request) {
    if r.Host != "portal.example" || r.URL.Path != "/status" {
        http.NotFound(w, r)
        return
    }
    w.WriteHeader(http.StatusNoContent)
}

func TestHostRouting(t *testing.T) {
    cases := []struct {
        name, target, host, headerHost, wantHost, wantURLHost string
        wantCode int
    }{
        {"路径默认主机", "/status", "", "", "example.com", "", 404},
        {"显式主机", "/status", "portal.example", "", "portal.example", "", 204},
        {"只改头集合", "/status", "", "portal.example", "example.com", "", 404},
        {"完整地址", "http://portal.example/status", "", "", "portal.example", "portal.example", 204},
        {"错误主机", "/status", "other.example", "", "other.example", "", 404},
        {"错误路径", "/other", "portal.example", "", "portal.example", "", 404},
        {"带端口", "/status", "portal.example:8080", "", "portal.example:8080", "", 404},
    }

    for _, tc := range cases {
        t.Run(tc.name, func(t *testing.T) {
            req := httptest.NewRequest(http.MethodGet, tc.target, nil)
            if tc.host != "" {
                req.Host = tc.host
            }
            if tc.headerHost != "" {
                // 故意保留错误写法作为反例，证明它不改变 req.Host。
                req.Header.Set("Host", tc.headerHost)
            }
            if req.Host != tc.wantHost || req.URL.Host != tc.wantURLHost {
                t.Fatalf("请求形状不符: Host=%q URL.Host=%q", req.Host, req.URL.Host)
            }

            recorder := httptest.NewRecorder()
            hostHandler(recorder, req)
            response := recorder.Result()
            defer response.Body.Close() // 释放 Result 提供的响应体。

            if response.StatusCode != tc.wantCode {
                t.Fatalf("状态码=%d，预期=%d", response.StatusCode, tc.wantCode)
            }
        })
    }
}

这个测试同时写明了对象字段的预期与路由结果。只断言状态码而不看构造出的 Host，有可能把“请求根本没设置对”误读成“业务处理失败”。其中“只改头集合”故意制造了一个 Header 与 Host 不一致的内存对象，价值在于揭示错误测试写法，不是模拟合法报文解析后必然出现的状态。

直接调用 hostHandler 测的是这段函数本身，不会自动经过项目真正的中间件、ServeMux 或第三方路由器。若问题发生在路由器的 Host 规则中，应该把 recorder 和 req 交给实际的顶层 Handler，再检查相应的匹配策略；不同路由器对端口和主机规范化的规则不要混用。

需要 HTTP 往返时分开连接地址与 Host

如果想确认客户端发出的 Host 能被服务端读取，就用 httptest.NewServer。此时连接目标是测试服务器的本地地址，业务主机则由客户端 Request.Host 覆盖。不要把 URL 改成测试域名，导致客户端真的尝试向那个域名连接。

下面另存为 vhost_integration_test.go，和上一份文件位于同一包，复用其 hostHandler。使用 net/http.NewRequest 构造客户端请求，而不是把面向服务端的 httptest.NewRequest 直接交给 Client.Do。

package vhost

import (
    "net/http"
    "net/http/httptest"
    "testing"
    "time"
)

func TestHostOverHTTP(t *testing.T) {
    server := httptest.NewServer(http.HandlerFunc(hostHandler))
    defer server.Close() // 测试结束释放本地监听器。

    client := server.Client()
    client.Timeout = 3 * time.Second // 避免异常连接让测试无限等待。
    req, err := http.NewRequest(http.MethodGet, server.URL+"/status", nil)
    if err != nil {
        t.Fatal(err)
    }
    req.Host = "portal.example" // URL 保持本地连接地址，单独覆盖 HTTP 主机。

    response, err := client.Do(req)
    if err != nil {
        t.Fatal(err)
    }
    defer response.Body.Close()
    if response.StatusCode != http.StatusNoContent {
        t.Fatalf("状态码=%d，预期=%d", response.StatusCode, http.StatusNoContent)
    }
}

这里的连接地址来自 server.URL，客户端 URL.Host 仍是测试服务器的 host:port。Request.Host 指定业务主机；到达服务器后，Handler 读取入站请求的 r.Host。这种拆分既不要求真实 DNS，也不需要公网服务，代价是比纯内存 Handler 测试多了一次本地 HTTP 往返。

哪些边界不能靠设置 Host 模拟

给 httptest.NewRequest 传 https URL 会设置一个模拟的 TLS 状态，并不执行 TLS 握手。修改 Request.Host 也不能证明 DNS、证书主机名或 SNI 已经配置正确。若只排查本文的路由判断，把这些边界分开，测试目的会更清楚。

Request.Host 可以包含端口。示例选择精确匹配，所以 portal.example:8080 不会被当成 portal.example；真实项目要先定义是否忽略端口，再增加相应测试，而不是用简单字符串截断去处理所有地址，特别是带冒号的 IPv6。

Host 能参与路由，不代表它能充当用户身份或租户授权。也不要在没有明确代理约定的情况下，把 X-Forwarded-Host 等普通头字段当作 Request.Host 的自动替身。本文只测试标准字段与路由输入，不把设置字段等同于完成安全验证。

# 在保存了两个测试文件的 Go 模块目录执行；-count=1 避免复用测试缓存。
go test -run '^TestHost' -count=1 ./...

预期检查点是两组测试均通过；若失败，先看字段断言，后看路由状态码。本次写作未执行上述命令，因此不展示 PASS 或耗时记录。

Header.Get("Host") 为空是不是请求损坏了？

不是。标准入站请求把 Host 存在专用字段，应该检查 r.Host。普通头集合缺少这个条目是正常情况。

只测路径路由时，还需要明确 Host 吗？

如果被测代码完全不依赖 Host，可以接受构造器默认值；一旦中间件或域名路由参与判断，最好让用例明确表达业务主机，防止默认 example.com 悄悄改变测试含义。

用完整 URL 会访问真实域名吗？

单独调用 httptest.NewRequest 不会发起连接。但通过 HTTP 客户端发送请求是另一回事：本地往返测试应使用 server.URL 作为连接目标，再设置 Request.Host。

适合直接调用 Handler 的是字段和分支测试；需要检查 HTTP 请求转换时，再加本地测试服务器。两者互补，关键不是多写一个 Host 头，而是把字段、连接目标和被测路由放在各自正确的位置。

参考：httptest 请求构造说明、http.Request 字段文档、Go 官方 httptest 实现。