在 Go 的 HTTP 服务中，可通过手动调用 ResponseWriter.WriteHeader() 设置状态码，再执行模板渲染，从而向客户端返回带自定义内容的 500 错误页面。
在 go 的 http 服务中，可通过手动调用 `responsewriter.writeheader()` 设置状态码，再执行模板渲染，从而向客户端返回带自定义内容的 500 错误页面。
在 Go Web 开发中，http.Error() 是快速返回错误响应的便捷方式，但它仅支持纯文本或简单 HTML 字符串，无法渲染结构化模板（如含布局、CSS、动态数据的错误页）。若需返回一个美观、一致且可复用的 500 错误页面（例如包含导航栏、错误详情和品牌样式），必须绕过隐式 200 OK 状态，显式设置状态码后再执行模板。
关键在于：WriteHeader() 必须在任何响应写入（包括 t.Execute()）之前调用。因为一旦 ResponseWriter 开始写入响应体（如模板输出到 http.ResponseWriter），HTTP 状态行已默认以 200 OK 发送，后续再调用 WriteHeader() 将被忽略（Go 会记录警告日志但不生效）。
✅ 正确做法如下：
func handlePage(w http.ResponseWriter, r *http.Request) {
t, err := template.ParseFiles("error500.html", "layout.html")
if err != nil {
http.Error(w, "Template parse error", http.StatusInternalServerError)
return
}
// 构造错误上下文数据（可包含错误信息、时间戳、请求ID等）
pageData := struct {
Message string
Time time.Time
}{
Message: "服务器内部错误，请稍后重试",
Time: time.Now(),
}
// ✅ 关键步骤：先设置状态码
w.WriteHeader(http.StatusInternalServerError)
// ✅ 再执行模板，内容将作为 500 响应体发送
if err := t.Execute(w, pageData); err != nil {
// 模板执行失败时，退回到基础错误响应（避免空白页）
http.Error(w, "Template execution failed", http.StatusInternalServerError)
return
}
}
⚠️ 注意事项：
- 不要混用
http.Error()和模板渲染——http.Error()内部已调用WriteHeader()并立即写入响应，之后再调用t.Execute()会导致http: multiple response.WriteHeader calls错误； - 模板文件（如
error500.html）应设计为独立可读的错误页，建议复用主站布局以保持 UI 一致性； - 生产环境建议添加错误日志（如
log.Printf("500 error: %v", err)）并关联请求追踪 ID，便于排查； - 若使用中间件（如 Gin、Echo），其错误处理机制通常已封装该逻辑，但原生
net/http需手动控制。
总结：返回带模板的 500 响应 = w.WriteHeader(http.StatusInternalServerError) + t.Execute(w, data)，顺序不可颠倒。这一模式同样适用于 404、403 等其他自定义错误页，是构建健壮 Go Web 应用的基础实践。
