在 Go 的 HTTP 服务中，可通过手动调用 ResponseWriter.WriteHeader(http.StatusInternalServerError) 设置状态码，再执行模板渲染，从而在自定义错误页面中正确返回 500 响应。
在 go 的 http 服务中，可通过手动调用 `responsewriter.writeheader(http.statusinternalservererror)` 设置状态码，再执行模板渲染，从而在自定义错误页面中正确返回 500 响应。
在 Go Web 开发中，http.Error() 是快速返回错误响应的便捷方式，但它仅支持纯文本或简单 HTML 字符串，无法渲染结构化模板（如包含布局、变量插值或条件逻辑的 HTML 页面）。若需向用户展示美观、一致且可复用的 500 错误页（例如带导航栏、样式和动态错误信息的页面），必须绕过 http.Error()，转而显式控制 HTTP 状态码与模板执行流程。
核心要点在于：HTTP 状态码必须在响应体写入前设置。ResponseWriter 的 WriteHeader() 方法用于显式发送状态行；若未调用，首次调用 Write() 或 t.Execute() 会隐式触发 WriteHeader(http.StatusOK)，导致后续再调用 WriteHeader() 失效（Go 会忽略重复或晚于响应体的设置）。
✅ 正确做法如下：
func handler(w http.ResponseWriter, r *http.Request) {
t, err := template.ParseFiles("error500.html")
if err != nil {
http.Error(w, "Template parse error", http.StatusInternalServerError)
return
}
// 关键：先设置状态码，再执行模板
w.WriteHeader(http.StatusInternalServerError)
// 模板数据可包含错误详情（注意安全：避免直接输出敏感信息）
data := struct {
Message string
Code int
}{
Message: "Something went wrong on our end.",
Code: 500,
}
if err := t.Execute(w, data); err != nil {
// 模板执行失败时，已发 500 状态码，但响应体可能不完整；
// 可记录日志，但不应再调用 WriteHeader
log.Printf("Template execution failed: %v", err)
}
}
? 注意事项：
-
顺序不可颠倒：
WriteHeader()必须在t.Execute()之前调用，否则状态码将保持默认200 OK。 -
错误处理要分层：模板解析失败（
ParseFiles）应在WriteHeader之前处理；模板执行失败（Execute）则发生在状态码已设定之后，此时仅需记录日志，无需重设状态码。 -
安全性提醒：若将运行时错误信息（如
err.Error()）传入模板，请确保已过滤敏感字段（如路径、堆栈、配置内容），防止信息泄露。 -
一致性建议：将错误模板逻辑封装为辅助函数（如
renderError(w, status, data)），便于在多个路由中复用。
通过这一模式，你既能保持 HTTP 协议语义的准确性（返回真实 500 Internal Server Error），又能提供专业、友好的错误用户体验——这才是健壮 Web 服务的标准实践。
