在 Go 的 net/http 包中，需调用 http.ResponseWriter.WriteHeader() 显式设置 HTTP 状态码（如 403、500），否则首次调用 Write() 会自动发送 200 OK；该方法必须在写入响应体前调用，且不可重复调用。
在 go 的 `net/http` 包中，需调用 `http.responsewriter.writeheader()` 显式设置 http 状态码（如 403、500），否则首次调用 `write()` 会自动发送 200 ok；该方法必须在写入响应体前调用，且不可重复调用。
Go 的 HTTP 处理器（http.Handler）通过 http.ResponseWriter 向客户端返回响应。值得注意的是：状态码并非由 Write() 自动推断，而是由 WriteHeader() 显式控制。若未显式调用 WriteHeader()，则第一次调用 w.Write() 时，Go 会隐式插入 WriteHeader(http.StatusOK)（即状态码 200），这容易导致错误状态码被忽略。
正确用法示例
func handler(w http.ResponseWriter, r *http.Request) {
// ✅ 正确：先设置状态码，再写入响应体
w.WriteHeader(http.StatusForbidden) // 403
w.Write([]byte("Access denied"))
}常见陷阱与注意事项
- ❌ 顺序错误：
w.Write()在WriteHeader()之前调用，将导致状态码被锁定为 200，后续WriteHeader()调用无效（Go 会忽略并记录警告日志）。 - ❌ 重复调用：多次调用
WriteHeader()仅第一次生效，后续调用无效果且可能引发http: multiple response.WriteHeader calls错误（尤其在中间件或封装逻辑中需格外注意）。 - ✅ 推荐实践：结合
http.Error()快速返回标准错误响应：http.Error(w, "Internal Server Error", http.StatusInternalServerError)
该函数内部已安全调用
WriteHeader()和Write()，适用于简单错误场景。
进阶提示
对于结构化响应（如 JSON API），建议统一封装响应逻辑：
func writeJSON(w http.ResponseWriter, statusCode int, v interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(statusCode)
json.NewEncoder(w).Encode(v)
}
// 使用示例
writeJSON(w, http.StatusOK, map[string]string{"message": "success"})
writeJSON(w, http.StatusNotFound, map[string]string{"error": "not found"})总之，WriteHeader() 是控制 HTTP 状态码的核心机制，务必确保其调用时机早于任何 Write() 操作，并避免重复调用——这是构建健壮、符合 HTTP 规范的 Go Web 服务的基础。
