Go HTTP 服务测试中 httptest.ResponseRecorder 状态码为何是 200

在 Go 的 HTTP 单元测试里，httptest.NewRecorder() 得到 200 并不奇怪：构造函数本身把 Code 初始化为 200；如果 Handler 只调用 Write 或 WriteString，首次写入又会按 HTTP 规则隐式记录 200。真正要测错误响应时，必须在写正文前调用 WriteHeader，并优先从 recorder.Result().StatusCode 读取最终响应。

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

为什么普通响应会得到 200

ResponseRecorder 同时扮演两种角色：一边实现 http.ResponseWriter，记录 Handler 写入的内容；另一边保存测试代码稍后要读取的状态、响应头和正文。NewRecorder 创建它时已经设置 Code: 200，因此下面这种最小 Handler 不调用 WriteHeader，仍会得到成功状态。

func okHandler(w http.ResponseWriter, r *http.Request) {
    // 写正文会触发 ResponseRecorder 的隐式 200。
    w.Write([]byte("ok"))
}

rec := httptest.NewRecorder()
req := httptest.NewRequest(http.MethodGet, "/health", nil)
okHandler(rec, req)
resp := rec.Result()
// 从最终响应对象读取状态，避免依赖内部字段。
fmt.Println(resp.StatusCode) // 200

首次正文写入前，Recorder 会补上状态 200，并根据正文尝试推断 Content-Type。所以“没有显式写 200”不等于“没有状态码”，而是使用了 http.ResponseWriter 的默认成功语义。

显式错误状态必须先于正文

当 Handler 要返回 404、401 或 500 时，先调用 WriteHeader，再写正文。状态码一旦记录，后面的 Write 只追加正文，不会把它改回 200。

func missingHandler(w http.ResponseWriter, r *http.Request) {
    // 先锁定错误状态，再写给调用方看的说明。
    w.WriteHeader(http.StatusNotFound)
    _, _ = w.Write([]byte("resource not found"))
}

rec := httptest.NewRecorder()
missingHandler(rec, httptest.NewRequest(http.MethodGet, "/items/9", nil))
resp := rec.Result()
// 状态码、响应头和正文都从同一份结果快照读取。
if resp.StatusCode != http.StatusNotFound {
    t.Fatalf("status = %d, want 404", resp.StatusCode)
}

同一个 Recorder 重复调用 WriteHeader 也遵循“第一次有效”：第一次写 404 后再写 200，最终仍是 404。这是测试中常见的误判来源，尤其是在公共响应函数已经写过状态码、上层又试图补写状态的场景。

Code 为 0 时，先检查 Recorder 的创建方式

官方文档特别提醒：如果 Handler 既没有调用 WriteHeader，也没有调用 Write，直接读取 Code 可能看到 0，而不是 HTTP 层面的隐式 200。最容易触发这个差异的写法是直接构造 &httptest.ResponseRecorder{}，而不是使用 NewRecorder()。

这里的 0 更像是 Recorder 尚未记录任何写入的内部状态，不应直接当成线上 HTTP 客户端收到的状态。测试代码应使用官方构造函数，并让 Handler 结束后再调用 Result()。

把断言写在真正的响应对象上

Result() 会返回包含 StatusCode、Header 和 Body 的 http.Response。这份结果应在 Handler 完成后读取；响应头也是写入时点的快照，不能在状态已经记录后才期待所有新 Header 反映到最终响应。

可以把状态码测试收敛为三点：成功分支检查 200，错误分支检查明确的 4xx/5xx，所有分支都从 Result() 读取并按需检查响应头和正文。这样既能覆盖默认状态，也能避免把 Recorder 的内部实现细节扩散到测试套件。

常见问题

只调用 WriteHeader(200) 还要再 Write 吗？

不需要。它只负责记录状态；如果需要正文，再单独调用 Write。

为什么 WriteHeader(404) 后读到的还是 200？

常见原因是正文已经先写入，第一次写入已经隐式锁定 200；把 WriteHeader(404) 移到所有正文写入之前。

能不能直接断言 recorder.Code？

可以用于简单兼容测试，但完整响应更适合断言 recorder.Result().StatusCode，并同时检查 Header 与 Body。

记住一句话：ResponseRecorder 的 200 可能来自构造函数，也可能来自第一次写入；错误状态必须抢在第一次写入之前，最终断言则应面向 Result() 返回的响应。