Go httptest.ResponseRecorder Code 为零时应该看哪个字段

在 Go 的 HTTP 单元测试里，httptest.ResponseRecorder.Code 读到 0，并不表示接口返回了 HTTP 0。它表示处理器还没有通过 WriteHeader 或写入响应体显式落下状态码。测试真正要判断 handler 生成的响应时，应在 handler 执行结束后调用 recorder.Result().StatusCode；没有显式写状态的普通成功响应会按 HTTP 语义得到 200。

Code 为什么会是 0

ResponseRecorder 实现了 http.ResponseWriter，它会记录 handler 对响应作出的改变。Code 这个字段记录的是状态码写入动作，而不是把 HTTP 协议里“默认成功”的概念提前填入结构体。

因此下面这个 handler 只设置了响应头，没有调用 WriteHeader，也没有写 Body。handler 返回时，recorder.Code 仍可能是 0；但从 HTTP 响应语义看，状态码是隐含的 200。

只要 handler 调用了 w.WriteHeader(http.StatusCreated)，或者通过 w.Write 写出了响应体，记录器就会进入显式响应状态，此时读取 Code 通常能看到对应值。问题在于，测试若只断言 Code，就会把“没有显式写状态”误判成“状态码缺失”。

用 Result().StatusCode 统一判断

更稳定的写法是先让 handler 完成，再把 recorder 转成响应对象。Result 会提供至少包含 StatusCode、Header 和 Body 的 *http.Response。它必须在 handler 运行结束后调用。

func TestHealth(t *testing.T) {
    // 这个 handler 没有主动写状态码，测试要覆盖隐含的 200。
    handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("X-Check", "ok")
    })

    recorder := httptest.NewRecorder()
    request := httptest.NewRequest(http.MethodGet, "/health", nil)
    handler.ServeHTTP(recorder, request)

    // handler 已经结束；从最终响应对象读取协议语义。
    response := recorder.Result()
    if response.StatusCode != http.StatusOK {
        t.Fatalf("status = %d, want %d", response.StatusCode, http.StatusOK)
    }
    if response.Header.Get("X-Check") != "ok" {
        t.Fatalf("X-Check = %q, want ok", response.Header.Get("X-Check"))
    }
}

这个断言把状态码、响应头和 Body 放在同一个响应快照里理解，避免在 Code、HeaderMap 和 Body 之间拼出一份不完整的结果。

什么时候还可以读 Code

如果测试专门关注 handler 是否显式调用了某个状态码，读取 Code 仍有意义。例如错误分支明确执行 WriteHeader(http.StatusBadRequest)，可以断言它产生了 400。不过这属于“记录器写入行为”的测试，不等于完整的最终响应断言。

测试里最容易踩的三个坑

第一，不要在 handler 还没返回时调用 Result；官方文档明确要求等 handler 完成。第二，不要把 HeaderMap 当作长期断言接口，它是历史兼容字段，最终响应头应从 Result().Header 读取。第三，若 handler 只设置 Header 而完全不写响应，检查 Code == 0 只能说明没有显式写状态，不能据此判定请求失败。

如果你的测试还要判断 Body，可以先保存响应对象，再读取它；不要为了让 Code 变成 200 而在生产 handler 里无意义地补一行 WriteHeader(http.StatusOK)。测试应贴合真实 handler 的响应路径。

相关问题

调用 Write 后还需要手动调用 WriteHeader(200) 吗？

通常不需要。写响应体会触发默认成功状态；测试最终状态时仍以 Result().StatusCode 为准。

为什么 HeaderMap 不适合新测试？

它只代表记录器的历史内部字段。要判断 handler 完成后的响应头，使用 recorder.Result().Header 更符合当前 API 语义。

Result 可以在 handler 执行前调用吗？

不可以。先完成 ServeHTTP 调用，再调用 Result，否则得到的响应快照不能代表最终结果。