如何在Golang中进行端口与网络测试_Golang net/http与httptest方法_技术教程

httptest.NewServer 用于快速启动内存 HTTP 服务并自动分配空闲端口，返回含 URL 字段的 *httptest.Server，适合并行测试但需调用 Close() 防泄漏；net.Listen 用于真实端口测试网络行为；NewUnstartedServer 支持启动前配置 TLS 或超时；切勿混用 http.Serve 与 httptest。

用 `httptest.NewServer` 快速启动测试 HTTP 服务

不需要真实监听端口，httptest.NewServer 会自动分配空闲端口并启动一个内存中的 HTTP 服务器。它返回的 *httptest.Server 包含 URL 字段（如 "http://127.0.0.1:34215"），可直接用于客户端请求。

常见错误是手动拼接 URL 或硬编码端口，导致并发测试失败或端口冲突。

每次调用 httptest.NewServer 都会绑定新端口，适合并行测试
务必在测试结束时调用 srv.Close()，否则 goroutine 和监听器会泄漏
若需自定义 handler，传入 http.Handler；默认使用 http.DefaultServeMux

srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("ok"))
}))
defer srv.Close() // 关键：不加这句会导致测试间干扰
resp, _ := http.Get(srv.URL + "/health")
defer resp.Body.Close()

用 `net.Listen` 测试真实端口占用与连接行为

当你要验证程序是否正确处理端口被占用、连接拒绝、超时等底层网络问题时，httptest 不够用，必须用 net.Listen 启动真实 listener。

注意：net.Listen("tcp", ":0") 中的 :0 表示让系统自动选端口，但返回的 Listener 的 Addr() 才是实际绑定地址，不能假设为 localhost:0。

测试端口占用：先用 net.Listen("tcp", ":8080") 占住端口，再运行被测代码，观察是否返回 address already in use
测试连接拒绝：启动 listener 后立刻 Close()，再尝试 net.Dial，会触发 connection refused
net.Listen 返回的地址可能包含 IPv6 地址（如 [::1]:37123），客户端请求时需保持协议一致

l, err := net.Listen("tcp", ":0")
if err != nil {
    log.Fatal(err)
}
defer l.Close()
addr := l.Addr().String() // 实际绑定地址，例如 "127.0.0.1:37123"
fmt.Println("Listening on", addr)

用 `httptest.NewUnstartedServer` 控制启动时机与 TLS 配置

当你需要在 listener 启动前修改其配置（比如设置 ReadTimeout、替换 tls.Config、或注入自定义 net.Listener）时，httptest.NewUnstartedServer 是唯一选择。

它返回未启动的 server，你可以手动调用 Start() 或 StartTLS()，甚至用 server.Listener = yourCustomListener 替换底层 listener。

测试 TLS 握手失败：传入无效证书，调用 StartTLS()，再用 http.Client 发起 HTTPS 请求
测试超时行为：设置 srv.Config.ReadTimeout = 100 * time.Millisecond，然后发慢请求
不能对已启动的 *httptest.Server 修改 listener，必须用 unstarted 版本

srv := httptest.NewUnstartedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    time.Sleep(200 * time.Millisecond)
    w.Write([]byte("slow"))
}))
srv.Config.ReadTimeout = 100 * time.Millisecond
srv.Start()
defer srv.Close()

避免混淆 `http.Serve` 与 `httptest` 的适用场景

http.Serve 是生产级阻塞式服务启动方式，而 httptest 系列专为单元测试设计。混用会导致测试卡死、goroutine 泄漏或 panic。

典型误用：在测试函数里写 http.Serve(l, mux) 而不启 goroutine，整个测试会 hang 住；或者忘记关闭 httptest.Server 导致后续测试端口冲突。

单元测试中永远优先用 httptest.NewServer 或 NewUnstartedServer
集成测试中若需模拟真实进程行为（如子进程启动 HTTP 服务），才考虑 http.Serve + goroutine + 显式 close listener
httptest.ResponseRecorder 仅用于 handler 单元测试（不走网络），和端口无关，别和 NewServer 搞混

真正容易被忽略的是 listener 生命周期管理 —— httptest.Server 的 Close() 不仅关 server，还关 underlying listener 和所有活跃连接；而自己用 net.Listen 时，必须手动关 listener 并确保无 pending accept。