HTTP 重定向响应中为何无法添加响应体？

Go 的 net/http 包明确规定：一旦调用 WriteHeader() 或 Write()，后续对响应头（如 location）的修改将被忽略；因此必须先设置 Location 头，再写入状态码和可选正文。

go 的 `net/http` 包明确规定：一旦调用 `writeheader()` 或 `write()`，后续对响应头（如 `location`）的修改将被忽略；因此必须先设置 `location` 头，再写入状态码和可选正文。

在 Go Web 开发中，实现 HTTP 重定向（如 301 或 302）时，一个常见误区是先写状态码或响应体，再设置 Location 响应头。这会导致重定向失败——浏览器收不到 Location 头，从而无法跳转。

根本原因在于 http.ResponseWriter 接口的设计约束：
✅ Header() 返回的是将随响应发送的 header 映射；
⚠️ 一旦调用 WriteHeader() 或 Write()，对该 header 的任何修改都将失效（文档明确说明：“Changing the header after a call to WriteHeader (or Write) has no effect.”）。

因此，正确的执行顺序必须是：

1. 先调用 w.Header().Set(“Location”, “/target”) 设置重定向目标；
2. 再调用 w.WriteHeader(statusCode) 发送状态行；
3. （可选）最后调用 w.Write([]byte{…}) 写入响应体（如提示文本）。

以下是修正后的完整示例代码：

func handleRedirect(w http.ResponseWriter, r *http.Request) {     // ✅ 正确：先设置 Location 头     w.Header().Set("Location", "/myredirecturl")      // ✅ 然后发送 301 状态码     w.WriteHeader(http.StatusMovedPermanently) // 即 301      // ✅ 可选：写入简短响应体（部分客户端会显示）     w.Write([]byte("Redirecting to /myredirecturl...")) }

? 补充说明：虽然 HTTP/1.1 规范（RFC 7231）允许重定向响应携带响应体（例如用于向用户展示跳转提示），但大多数浏览器忽略该内容，仅依据 Location 头执行跳转。因此，响应体主要用于调试、日志或兼容性兜底，不可依赖其可见性。

⚠️ 注意事项：

• 不要调用 w.Header().Set(“Content-Length”, …) 手动设置长度：net/http 会在 Write() 后自动计算并覆盖该值；手动设置可能引发不一致甚至连接错误。
• 避免在 WriteHeader() 后调用 w.Header().Set(…) —— 此操作静默失效，且无运行时错误提示，极易引入隐蔽 bug。
• 更推荐使用标准辅助函数：http.Redirect(w, r, “/myredirecturl”, http.StatusMovedPermanently)，它内部已严格遵循上述顺序，并自动处理 Content-Type、Content-Length 和安全头（如 X-Content-Type-Options）。

总结：Go 的响应写入是“单向流”设计——头 → 状态 → 体。违背此顺序将导致语义丢失。牢记“Header first, then WriteHeader, finally Write”，即可可靠实现带提示文本的重定向。