HTTP 测试断言

写 Go 的 HTTP handler 测试时，httptest.NewRecorder() 得到的 ResponseRecorder.Code 为 0，并不表示响应状态码是 0。它只说明 handler 没有显式调用 WriteHeader，也没有通过写入响应体触发 recorder 记录状态。要断言客户端最终看到的状态，应在 handler 完成后读取 recorder.Result().StatusCode；要研究 handler 是否主动写过状态，才读取 Code。

先把 Code 为 0 的语义分开

我第一次遇到这个现象，是在测试一个只负责设置响应头、把结果交给中间件处理的 handler。断言 rec.Code == http.StatusOK 直接失败，但这不是 handler 返回了异常状态，而是 recorder 还没有看到一次“写状态”动作。ResponseRecorder.Code 的职责很窄：记录 WriteHeader 写入的状态；它不是客户端最终响应的完整视图。

下面三种写法容易被混在一起：

func handler(w http.ResponseWriter, r *http.Request) {
	// 显式写入状态，rec.Code 会记录 201。
	w.WriteHeader(http.StatusCreated)
}

func bodyHandler(w http.ResponseWriter, r *http.Request) {
	// 首次写响应体会触发隐式 200，但测试字段的观察时机仍要分清。
	_, _ = w.Write([]byte("ok"))
}

func quietHandler(w http.ResponseWriter, r *http.Request) {
	// 什么都不写；最终 HTTP 语义仍按 net/http 规则落到 200。
}

旧写法为什么会把合法响应判成失败

如果测试只检查 rec.Code，就把“有没有显式写状态”和“最终状态是多少”混成了一个问题。尤其是空响应、只设置 Header、或者状态由后续包装器统一写出的 handler，Code == 0 只是说明 recorder 没有记录到显式写入。

还有一个容易踩的边界：HeaderMap 是历史兼容字段，不适合拿来代表最终返回的 Header。响应头可能包含由 HTTP 语义补上的内容，最终结果应该从 Result().Header 读取。图中的两个分组可以理解为“handler 的写入动作”和“最终响应快照”，它们相关，但不是同一个数据面。

把状态断言迁移到 Result

更稳的测试顺序是：创建 request 和 recorder，调用 handler，等待 handler 返回，再取得 Result()；状态、响应头和正文都从这个结果对象读取。

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

	quietHandler(rec, req)

	// Code 只回答“是否显式写入”；最终状态从 Result 读取。
	if rec.Code != 0 {
		t.Fatalf("quiet handler unexpectedly wrote status: %d", rec.Code)
	}
	resp := rec.Result()
	defer resp.Body.Close() // 读取结果后关闭测试响应体，保持资源习惯一致。
	if resp.StatusCode != http.StatusOK {
		t.Fatalf("status = %d, want %d", resp.StatusCode, http.StatusOK)
	}
}

对于真实业务 handler，通常不必额外断言 Code == 0，因为它把测试绑定到了实现细节。更有价值的是断言状态、关键 Header 和 Body。只有在验证“某个分支必须显式返回错误码”时，才把 Code 作为辅助观察值。

几个边界要写进断言清单

Result() 要在 handler 完成后调用；返回的 Body 应按普通 io.ReadCloser 习惯关闭。不要对整个 http.Response 做深度相等比较，因为标准库未来可能补充字段。还要注意，重复调用 WriteHeader 并不会让测试得到一个“最后一次状态”，因此更应该围绕最终语义和业务结果设计断言。

常见问题

为什么 handler 什么都不写，StatusCode 仍然是 200？

这是 HTTP server 的隐式成功语义。不要用 ResponseRecorder.Code 的 0 代替最终响应状态，读取 Result().StatusCode。

测试只看 Header 时应该用哪个字段？

handler 执行完成后用 rec.Result().Header。HeaderMap 是历史兼容字段，不能代表最终响应快照。

什么时候还值得断言 Code？

当测试目标就是确认某个分支主动调用了 WriteHeader，或者要区分“显式写状态”和“依赖隐式 200”时，它才有辅助价值。

把 Code 看作“写入动作记录”，把 Result() 看作“最终响应快照”，HTTP 测试断言就不会再被一个看似异常的 0 带偏。