Go 怎样用 NewServer 搭建临时测试服务

Go 的 httptest.NewServer(handler) 会启动一个临时 HTTP 测试服务。把它返回的 server.URL 注入被测客户端，用测试专属 Client 发请求，并在测试结束时关闭服务，就能避免写死端口和依赖真实上游。它是实际的回环网络服务，不是只记录响应内容的 ResponseRecorder。

以库存查询为例：我们只关心客户端是否请求了正确路径、传入正确商品参数，并正确处理上游状态与正文。若用真实库存系统完成这些断言，网络波动和业务数据变化也会影响结果。更直接的办法是让测试拥有一个只认识演示商品的小上游。

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

先把真实上游从测试配置里拿掉

先修改依赖的形状，而不是先启动服务。这里把库存查询函数设计为接收 baseURL 和 client：应用运行时由应用配置传入，测试时则传入 server.URL 与专属 Client。函数内不读取生产域名、环境变量或全局客户端，也不额外请求真实服务“兜底”。

这是一种应用层隔离约定，不代表 NewServer 自动隔离整个进程的网络。被测逻辑若仍有硬编码地址或使用别的客户端，仍可能访问外部系统。测试数据应只使用演示标识，不携带正式账号、令牌和库存明细。

让NewServer只暴露本次需要的路由

给 NewServer 显式传入独立的 ServeMux，只注册 /stock。处理器再检查 GET 方法与 sku 参数，其他请求就不会意外拿到一个“总是成功”的响应。这样测试能识别路径拼错、查询丢失和方法不符，而不仅是证明某个端口能连通。

NewServer 已经启动服务，调用方不应再 Start 一次，也不需要 Sleep 等待。回环服务使用系统分配的端口，客户端通过返回 URL 定位，不把端口号写进断言。NewServer 文档

把请求约束和结果断言写进同一个用例

将下面完整代码保存为 stock_test.go。它将示例函数与用例放在同一文件，方便独立练习；实际项目可把 fetchStock 移到普通 Go 源文件中。返回的 available=7 是自定演示文本，并不是某个真实接口协议。

package inventory

import (
    "context"
    "fmt"
    "io"
    "net/http"
    "net/http/httptest"
    "net/url"
    "strings"
    "testing"
    "time"
)

// fetchStock 将地址与客户端作为依赖，不偷偷读取生产环境配置。
func fetchStock(ctx context.Context, client *http.Client, baseURL, sku string) (string, error) {
    target := strings.TrimRight(baseURL, "/") + "/stock?sku=" + url.QueryEscape(sku)
    req, err := http.NewRequestWithContext(ctx, http.MethodGet, target, nil)
    if err != nil {
        return "", fmt.Errorf("构造库存请求: %w", err)
    }
    resp, err := client.Do(req)
    if err != nil {
        return "", fmt.Errorf("发送库存请求: %w", err)
    }
    defer resp.Body.Close() // 请求成功返回响应以后，由调用方关闭响应体。
    if resp.StatusCode != http.StatusOK {
        return "", fmt.Errorf("库存接口状态异常: %d", resp.StatusCode)
    }
    const maxReply = 1024 // 示例响应最多 1 KiB，额外读一字节识别超限。
    data, err := io.ReadAll(io.LimitReader(resp.Body, maxReply+1))
    if err != nil {
        return "", fmt.Errorf("读取库存响应: %w", err)
    }
    if len(data) > maxReply {
        return "", fmt.Errorf("库存响应超过 %d 字节", maxReply)
    }
    return string(data), nil
}

func TestFetchStock(t *testing.T) {
    // 私有路由表不依赖其他用例注册的全局处理器。
    mux := http.NewServeMux()
    mux.HandleFunc("/stock", func(w http.ResponseWriter, r *http.Request) {
        if r.Method != http.MethodGet {
            w.WriteHeader(http.StatusMethodNotAllowed)
            return
        }
        if r.URL.Query().Get("sku") != "DEMO-27" {
            http.Error(w, "商品参数不符", http.StatusBadRequest)
            return
        }
        w.Header().Set("Content-Type", "text/plain; charset=utf-8")
        fmt.Fprint(w, "available=7") // 固定演示数据，不包含真实业务信息。
    })

    server := httptest.NewServer(mux)
    t.Cleanup(server.Close) // 由创建服务的测试拥有清理职责。

    client := server.Client()
    client.Timeout = 2 * time.Second
    client.CheckRedirect = func(req *http.Request, via []*http.Request) error {
        // 保留原始重定向响应，避免测试悄悄请求新的目标。
        return http.ErrUseLastResponse
    }
    ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
    defer cancel()

    got, err := fetchStock(ctx, client, server.URL, "DEMO-27")
    if err != nil {
        t.Fatal(err) // 只在测试 goroutine 中终止测试。
    }
    if got != "available=7" {
        t.Fatalf("库存响应不符: got=%q", got)
    }
}

这个用例并非只有最后一行判断：处理器的方法与 sku 约束会让错误请求得到非 200 状态，客户端显式检查状态码，测试再断言内容。请求路径若错误，私有 Mux 的响应也不会通过客户端状态判断。

Client 的 Timeout 限制请求整体耗时；Context 另外表达调用生命周期，两者同时存在时较早触发的约束会起作用。示例拒绝自动跟随重定向，因此意外的 302 会作为非 200 错误呈现。拒绝重定向不是 NewServer 的默认安全保证，而是这份测试配置的选择。HTTP Client 超时及重定向策略

响应体和临时服务分别怎样回收

响应体由 fetchStock 在拿到成功响应后 defer Close；临时服务由 TestFetchStock 注册 t.Cleanup(server.Close)。两个资源有不同的所有者，不能认为服务关闭后就不必处理每次请求返回的 Body。

Cleanup 在当前测试及其子测试完成后调用，后注册的清理先执行。若父测试创建服务供并行子测试共享，使用 Cleanup 比父函数直接 defer Close 更能表达“子测试也完成后才清理”的归属。不过共享处理器中的可变数据仍须同步；本例只读取请求和固定文本，没有共享计数器。T.Cleanup 的生命周期

Server.Close 会等待未结束的请求；如果 Handler 永久阻塞，测试收尾也可能卡住。编写阻塞或超时场景时，让 Handler 等待请求 Context 或显式释放信号，不把 Client 超时理解为能够强制终止任意服务端代码。测试服务清理实现

失败日志该保留什么

示例用状态码区分上游协议异常，用带 %w 的错误保留请求和读取失败原因。测试只在自己 goroutine 内调用 t.Fatal；不要在 HTTP Handler 内直接调用 Fatal 或 FailNow，Handler 应返回可断言响应，主测试再判断结果。

对于固定演示响应，输出 got 有助于定位差异；真实项目则应根据数据敏感性只记录状态、字段名或受限摘要，不把完整响应体、认证头和业务账户直接打印到 CI 日志。服务端错误响应也不要模拟真实凭据，避免“测试数据”进入仓库后仍能访问生产。

若用例越来越多，应把成功、非 200、错误内容和超限响应分成独立子测试。不要让一个用例总是返回相同成功文本，却在文章里声称它覆盖了重试、认证、超时和所有错误路径。本例实现的只是单次库存请求约定。

交给CI前要区分哪些测试边界

下面是供读者复现的命令，本文不运行测试或启动临时服务，也不提供虚构 PASS 日志：

# 在新的练习目录初始化模块，并保存 stock_test.go。
go mod init example.com/stock-client-demo
# 禁用测试结果缓存，仅执行这个用例；总超时避免无界等待。
go test -run '^TestFetchStock$' -count=1 -timeout=10s .

预期结果是用例通过；若改错 sku、路径或处理器响应内容，用例应失败。判断依据是用例退出状态和具体断言，不是端口固定、响应时间恰好几毫秒或输出顺序。

需要把 TLS 校验关掉吗？不要为了方便直接启用 InsecureSkipVerify。测试 TLS 上游时使用 NewTLSServer 返回的匹配客户端，按测试信任关系配置；生产 TLS 配置另行处理。

Go 1.27 的 NewTestServer 可以替代吗？当前官方文档把它列为多数新测试的优先选项：默认使用内存网络，并关联测试清理。它与本文启动回环服务的 NewServer 不是同一行为；本文保留标题指定的 NewServer 写法，兼容需要真实回环网络或已有用例的场景。不要把两者的配置和自动清理规则混在一起。NewTestServer 文档

临时服务的价值在于让依赖和生命周期可控，而不是把测试配置升级成生产服务。明确路由、注入地址、限定客户端行为、分别关闭资源，再把断言限定在实际覆盖范围内，这个测试才容易稳定地进入 CI。