Go 模板（html/template）仅用于数据渲染，不可执行重定向等 HTTP 控制逻辑；正确做法是在 HTTP 处理函数（handler）中判断条件并调用 http.Redirect()，模板只负责展示内容。
go 模板（`html/template`）仅用于数据渲染，不可执行重定向等 http 控制逻辑；正确做法是在 http 处理函数（handler）中判断条件并调用 http.redirect()，模板只负责展示内容。
在 Go Web 开发中，一个常见误区是试图在 HTML 模板内直接调用重定向操作（如 {{.Redirect "page1" 301}}），期望其像 ASP.NET Razor 那样“在视图中跳转”。但这是对 Go 模板设计哲学的根本误解。
✅ 正确架构：职责分离（Separation of Concerns）
Go 的 html/template 是纯展示层工具——它接收已准备好的数据（如结构体、字符串、布尔值），执行安全的插值与逻辑分支（{{if}}、{{range}}），最终生成 HTML 字符串。它不持有 http.ResponseWriter 引用，也无法修改 HTTP 状态码或响应头。一旦 handler 调用 template.Execute()，HTTP 响应头通常已隐式写入（默认 200 OK），此时再尝试重定向将失败或导致 http: multiple response.WriteHeader calls 错误。
? 为什么模板内重定向必然失败？
- 模板函数必须返回至少一个值（如 func() string 或 func() (string, error)），而 http.Redirect(w, r, url, code) 返回 error 且需操作 w http.ResponseWriter —— 模板无法提供该上下文；
- 即使通过反射或闭包“注入” ResponseWriter，也会破坏模板的无状态性与可测试性；
- 浏览器重定向依赖 3xx 状态码 + Location 响应头，这些必须在任何正文写入前由 handler 设置；模板执行时，header 极可能已被提交。
✅ 推荐实现：在 Handler 中完成决策与重定向
// main.go
func indexHandler(w http.ResponseWriter, r *http.Request) {
// 1. 处理 POST 请求：执行业务逻辑并重定向
if r.Method == "POST" {
// 可选：解析表单、校验、保存数据...
http.Redirect(w, r, "/page1", http.StatusMovedPermanently) // 301
return // ⚠️ 必须 return，阻止后续模板执行
}
// 2. GET 请求：渲染模板
data := struct {
Title string
Body template.HTML
ContentType string
Request *http.Request
}{
Title: "Home Page",
Body: "<p>Welcome!</p>",
ContentType: "text/html",
Request: r,
}
tmpl := template.Must(template.ParseFiles("index.tmpl"))
if err := tmpl.Execute(w, data); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}对应模板 index.tmpl 应移除所有重定向逻辑，仅专注渲染：
<html>
<head><title>{{.Title | title}}</title></head>
<body>
<h1>{{.Title}}</h1>
{{.Body}}
<p>Content Type: {{.ContentType}}</p>
<p>Method: {{.Request.Method}}</p>
<form method="POST">
<input type="text" name="lolcat" placeholder="Enter text">
<input type="submit" value="Submit">
</form>
</body>
</html>⚠️ 注意事项与最佳实践
- 永远在 http.Redirect() 后加 return：防止重定向后继续执行模板渲染，造成 panic 或脏响应；
- 避免自定义模板重定向函数：即使通过 template.FuncMap 注册 redirect: func(url string, code int) (string, error)，也因无法访问 ResponseWriter 而无效（参考 play.golang.org/p/b2I_uzjiSH 的错误示例）；
- 重定向时机要早：应在 template.Execute() 之前完成所有重定向判断；
-
状态码选择建议：
- http.StatusFound (302)：临时跳转（默认，兼容性好）；
- http.StatusMovedPermanently (301)：永久跳转（SEO 场景）；
- http.StatusSeeOther (303)：强制 GET 重定向（推荐用于 POST 后跳转，防止刷新重复提交）。
✅ 总结
模板不是控制器，而是视图。 所有路由决策、状态变更、HTTP 控制（重定向、错误响应、认证检查）都应在 handler 层完成；模板只做一件事：把结构化数据安全、清晰地转化为 HTML。遵循这一原则，你的 Go Web 应用将更健壮、可维护且符合标准实践。
