如何在 Go 的 HTTP 处理器中正确设置响应状态码-Golang-PHP中文网

如何在 Go 的 HTTP 处理器中正确设置响应状态码

本文详解 Go 语言中通过 http.ResponseWriter.WriteHeader() 显式设置 HTTP 状态码的方法，涵盖使用场景、调用时机、常见误区及完整示例。

本文详解 go 语言中通过 `http.responsewriter.writeheader()` 显式设置 http 状态码的方法，涵盖使用场景、调用时机、常见误区及完整示例。

在 Go 的标准 HTTP 服务中，http.ResponseWriter 默认会在首次调用 Write() 方法时自动发送 200 OK 状态码。若需返回非 200 的响应（如 403 Forbidden、500 Internal Server Error 或 404 Not Found），必须显式调用 WriteHeader() —— 这是唯一且标准的方式。

✅ 正确用法：调用 `WriteHeader()` 后再写入响应体

func handleExample(w http.ResponseWriter, r *http.Request) {
    // 设置状态码（必须在 Write 之前调用）
    w.WriteHeader(http.StatusForbidden) // 403
    // 可选：写入响应内容（不影响状态码）
    w.Write([]byte("Access denied."))
}

⚠️ 注意：WriteHeader() 只能调用一次，且必须在任何 Write() 或 WriteString() 调用之前执行。一旦响应头已发送（即 WriteHeader() 已触发或隐式调用），再次调用 WriteHeader() 将被忽略，且不会报错——这容易导致状态码“静默失效”。

❌ 常见错误示例（应避免）

func badHandler(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Error occurred")) // 隐式触发 WriteHeader(http.StatusOK)
    w.WriteHeader(http.StatusInternalServerError) // ❌ 无效！响应头已发送
}

此时客户端仍将收到 200 OK，而非预期的 500 —— 因为 Write() 已触发默认状态码，后续 WriteHeader() 被丢弃。

Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

✅ 最佳实践建议

始终优先设置状态码：逻辑判断后第一时间调用 WriteHeader()；
结合 http.Error() 简化错误响应（推荐用于标准错误）：

func handleError(w http.ResponseWriter, r *http.Request) {
    http.Error(w, "Unauthorized", http.StatusUnauthorized) // 自动调用 WriteHeader + Write
}

自定义 JSON 错误响应时，注意设置 Content-Type：

func jsonError(w http.ResponseWriter, code int, msg string) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    w.WriteHeader(code)
    json.NewEncoder(w).Encode(map[string]string{"error": msg})
}