http.Redirect 是 Go 中实现重定向的标准方式,自动设置状态码和 Location 头;常用 302、301、303 状态码,调用后须 return 避免重复写响应。

在 Go 的 HTTP 服务中,使用 http.Redirect 是最直接、标准的方式实现重定向。它会自动设置状态码(如 302)和 Location 响应头,浏览器收到后立即跳转。
理解 http.Redirect 的基本用法
http.Redirect 是一个便捷函数,封装了状态码、响应头和空响应体的处理。它的签名是:
func Redirect(w ResponseWriter, r *Request, url string, code int)
其中:
- w 是响应写入器
- r 是当前请求(用于判断是否为 POST 等)
- url 是目标地址,支持相对路径(如 "/login")或绝对 URL(如 "https://example.com")
- code 是 HTTP 状态码,常用值有:
• http.StatusFound(302,默认推荐,适用于大多数跳转)
• http.StatusMovedPermanently(301,表示永久重定向,会影响 SEO 和浏览器缓存)
• http.StatusSeeOther(303,强制将后续请求转为 GET,适合表单提交后跳转)
常见重定向场景与写法
以下是在实际 handler 中的典型用法:
- 登录成功后跳转到首页:
http.Redirect(w, r, "/", http.StatusFound) - 未登录访问受限页面,跳转至登录页:
http.Redirect(w, r, "/login?next="+url.PathEscape(r.URL.Path), http.StatusFound) - 表单提交后防止重复提交,用 303 跳转:
http.Redirect(w, r, "/success", http.StatusSeeOther) - 强制 HTTPS 重定向(在非安全请求时):
if r.URL.Scheme != "https" {
secureURL := "https://" + r.Host + r.URL.RequestURI()
http.Redirect(w, r, secureURL, http.StatusMovedPermanently)
return
}
注意事项和易错点
重定向不是“return”语句,而是向客户端发送响应。如果之后还继续写入响应体(比如调用 fmt.Fprint(w, "...")),会导致 “http: multiple response.WriteHeader calls” 错误。
立即学习“go语言免费学习笔记(深入)”;
- 调用
http.Redirect后务必return,避免后续逻辑执行 - 相对 URL 会被自动补全为完整路径(基于当前请求的 Host 和 Scheme),但不会自动加协议或域名;若需跨域跳转,请提供完整 URL
- 301 重定向可能被浏览器或 CDN 缓存,测试阶段建议先用 302,确认无误再切 301
- 如果要重定向并携带数据(如提示消息),不能靠重定向本身传递,需改用 session、cookie 或 URL 查询参数(如
?msg=success)
替代方式:手动设置重定向头(不推荐日常使用)
虽然可以直接写:
w.Header().Set("Location", "/new-path")
w.WriteHeader(http.StatusFound)但这种方式容易遗漏细节(比如没设状态码、重复写头、忘记终止 handler),可读性和健壮性不如
http.Redirect。仅在需要精细控制(如自定义 header 或延迟写入)时才考虑手动操作。
基本上就这些。用好 http.Redirect 不复杂,关键是选对状态码、记得 return、别在重定向后继续写响应。










