HTTP处理函数无返回值,错误须手动写响应;请求体只能读一次,需缓存复用;超时需分层设置ReadHeader/Write/Idle;重定向后必须return避免重复写响应。
为什么 http.HandleFunc 不能直接返回错误?
Go 的 HTTP 处理函数签名固定为 func(http.ResponseWriter, *http.Request),没有返回值。这意味着你无法用 return err 中断流程或向调用方抛错——所有错误必须手动写入响应体并设置状态码。
常见错误是只记录日志却忘记调用 w.WriteHeader(statusCode) 或 w.Write([]byte(...)),导致客户端收到空响应或 200 OK 的假成功。
- 必须显式调用
w.WriteHeader(http.StatusBadRequest)等设置状态码(注意:在w.Write之前调用,否则可能被忽略) - 推荐用
http.Error(w, "message", statusCode)一键完成状态码 + 文本响应,但注意它会自动加Content-Type: text/plain; charset=utf-8 - 若需 JSON 响应,应自己构造:
w.Header().Set("Content-Type", "application/json"),再json.NewEncoder(w).Encode(data)
如何安全读取 *http.Request 的请求体?
r.Body 是一次性可读的 io.ReadCloser,多次调用 io.ReadAll(r.Body) 会导致后续读取为空——尤其在中间件或日志中提前读取后,业务 handler 就拿不到原始数据了。
典型场景:想记录请求体又不影响后续逻辑。