Go中HTTP错误处理需显式设状态码再写响应体，推荐用http.Error；手动处理JSON错误时须先WriteHeader、再设Content-Type、最后编码输出。
在 Go 的 net/http 包中，正确处理 HTTP 错误不是靠 panic 或日志打印，而是通过主动控制响应状态码和响应体来实现。关键在于：先调用 ResponseWriter.WriteHeader() 设置状态码，再写入响应内容；更推荐的方式是直接使用 http.Error()，它已封装好常见逻辑。
理解 WriteHeader 的作用和时机
WriteHeader(statusCode int) 用于显式设置 HTTP 响应状态码（如 404、500）。它必须在任何响应体写入（如 w.Write() 或 fmt.Fprint(w, ...)）之前调用。一旦有数据写入，Go 会自动发送默认的 200 状态码，后续再调用 WriteHeader 将被忽略（且不会报错，容易埋下隐患）。
- ✅ 正确：先
w.WriteHeader(http.StatusNotFound)，再w.Write([]byte("not found")) - ❌ 错误：先
w.Write(...)，再w.WriteHeader(...)—— 状态码无效 - ⚠️ 注意：
WriteHeader不会自动结束请求，也不阻止后续写入
用 http.Error 快速返回标准错误响应
http.Error(w http.ResponseWriter, errorText string, statusCode int) 是最常用、最安全的错误响应方式。它内部已确保：先写状态码、再写响应体（带 text/plain; charset=utf-8 类型），并自动加换行符。
- 适合开发期快速反馈或简单 API 错误，例如：
http.Error(w, "user not found", http.StatusNotFound) - 它会自动设置
Content-Type和Content-Length，无需手动处理 - 不适用于需要 JSON 错误体或自定义头部的场景（此时需手动控制）
返回结构化错误（如 JSON）的完整写法
现代 API 通常返回 JSON 格式的错误，例如 {"error": "invalid token", "code": 401}。这时需手动设置状态码、内容类型，并编码数据：
立即学习“go语言免费学习笔记（深入）”；
- 先调用
w.WriteHeader(http.StatusUnauthorized) - 再设置头部：
w.Header().Set("Content-Type", "application/json; charset=utf-8") - 最后写入 JSON：
json.NewEncoder(w).Encode(map[string]interface{}{"error": "invalid token", "code": 401}) - 注意：不要在写 JSON 前调用
Write或其他输出，否则可能触发隐式 200
避免常见陷阱
实际编码中几个高频问题：
- 忘记调用
WriteHeader，导致错误响应仍是 200 —— 前端难识别失败 - 在中间件或 handler 中多次调用
WriteHeader（比如重定向后又写错误）—— 后续调用失效 - 用
log.Fatal或panic处理业务错误 —— 会终止整个服务，不是 HTTP 错误处理 - 返回错误时未设置
Content-Type，导致前端解析失败（尤其 JSON 场景）
基本上就这些。核心就一条：HTTP 错误 = 显式状态码 + 合理响应体 + 正确顺序。用好 http.Error 能覆盖大部分情况，复杂需求再手动控制即可。
