Go httptest.NewRecorder 的 Code 为什么默认是 200

使用 httptest.NewRecorder() 测试 Go Handler 时，很多人会看到 rec.Code 是 200，于是把它理解成 Recorder 的默认状态。这个理解不完整：Code 记录的是 Handler 是否提交过响应状态；如果 Handler 什么都没写，它可能仍为 0。只有写正文触发隐式提交，或主动调用 WriteHeader(http.StatusOK) 后，Code 才会显示 200。

Code 为什么有时是 200，有时却是 0

ResponseRecorder 是一个用于记录 http.ResponseWriter 变化的测试实现。它的 Code 字段表示 Handler 通过 WriteHeader 设置的响应码，而不是“创建 Recorder 时就完成了一次 HTTP 响应”。

真正容易混淆的是 Write。按照 net/http 的语义，Handler 没有显式写状态、但写入正文时，服务器会把响应状态视为 200。Recorder 会记录这个隐式提交，因此下面两种写法都可能看到 Code == 200：

handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    // 写正文会触发隐式的 200 状态。
    _, _ = io.WriteString(w, "ok")
})

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

fmt.Println(rec.Code) // 200

相反，如果 Handler 直接返回，没有调用 WriteHeader 或 Write，Code 可能保持为 0。这正是“默认是 200”这个说法容易误导的地方。

测试最终状态时为什么要用 Result().StatusCode

HTTP 客户端看到的是一个完整响应，而测试代码直接读取 Code 看到的是 Recorder 的内部记录。为了让断言更接近客户端视角，应该在 Handler 完成后调用 Result()，再读取返回响应的 StatusCode、Header 和 Body。

官方文档还特别说明，Result() 应在 Handler 执行结束后调用。如果 Handler 还在异步写入，过早读取结果会让测试观察到不完整状态。一个更稳妥的断言形态如下：

rec := httptest.NewRecorder()
req := httptest.NewRequest(http.MethodGet, "/health", nil)

// 只有 Handler 返回后，才读取最终响应。
handler.ServeHTTP(rec, req)
resp := rec.Result()
defer resp.Body.Close()

if resp.StatusCode != http.StatusOK {
    t.Fatalf("status = %d, want %d", resp.StatusCode, http.StatusOK)
}

这并不意味着 Code 没有用途。它适合观察 Handler 有没有调用状态提交逻辑；但如果测试目标是“客户端最终收到什么状态”，Result().StatusCode 更合适。

三个场景要用不同的断言

例如，一个“无内容也算成功”的 Handler 可以显式写出意图，避免测试依赖 Recorder 的未提交状态：

handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    // 没有响应体时，也显式提交业务约定的状态。
    w.WriteHeader(http.StatusNoContent)
})

rec := httptest.NewRecorder()
req := httptest.NewRequest(http.MethodDelete, "/sessions/1", nil)
handler.ServeHTTP(rec, req)

// Result 表示客户端视角的最终状态。
if got := rec.Result().StatusCode; got != http.StatusNoContent {
    t.Fatalf("status = %d, want %d", got, http.StatusNoContent)
}

别把 HeaderMap 当成最终响应入口

ResponseRecorder.HeaderMap 为历史兼容保留，官方文档已标记为不应使用的内部细节。要读取 Handler 完成后的响应头，应使用 rec.Result().Header；要读取正文则从 Result().Body 获取，并负责关闭它。

排查“为什么 Code 不是 200”时，可以按这个顺序看：Handler 是否真的调用了 Write 或 WriteHeader；是否在 Handler 返回前读取了 Recorder；测试断言的是内部字段还是最终响应；业务是否本来就允许空响应。不要只把 rec.Code 强行改成 200，因为那会掩盖 Handler 没有提交响应的事实。

常见问题

NewRecorder 创建后能不能直接断言 Code 等于 200？

不建议。创建后尚未执行 Handler，Code 可能是 0；先调用 Handler，再按测试目标选择 Code 或 Result().StatusCode。

只写响应头不写正文会自动得到 200 吗？

如果只是修改 Header() 返回的 map，还不算提交响应。需要显式调用 WriteHeader，或者写入正文触发隐式状态。

为什么 Result 不能在 Handler 运行中读取？

因为它代表 Handler 生成的结果，官方约定应在 Handler 完成后调用；并发写入时过早读取会让断言失去确定性。