是的。net/http.error内部调用writeheader并写入html格式错误体，不中断handler执行，必须手动return，否则后续写操作会触发“superfluous response.writeheader”panic；它默认content-type为text/html，不适用于api场景。
net/http.Error 会直接写入响应并结束处理吗？
是的。net/http.Error 内部调用 http.ResponseWriter.WriteHeader 并写入错误体，之后不会自动 panic 或中断 handler 执行 —— 你必须手动 return，否则后续代码仍会运行，可能造成重复写响应头或 body 的 panic（http: superfluous response.WriteHeader call）。
常见错误现象：handler 里调用了 http.Error 却没 return，接着又调用 w.Write 或设置 header，触发 runtime panic。
- 必须在
http.Error后立即return - 它不抛异常，也不控制流程，只是“写完就走”
- 底层等价于：
w.WriteHeader(status); w.Write([]byte(message))（message 会被 HTML-escaped）
为什么返回的错误页面是 HTML 而不是 JSON？
net/http.Error 默认使用 text/html; charset=utf-8 Content-Type，并对 message 做 HTML 实体转义（比如 <script></script> 变成 <script>）。它面向浏览器调试场景，不是为 API 设计的。
如果你的 endpoint 是 REST API，直接用 http.Error 返回 400/500 会导致前端收到 HTML 字符串，解析失败。
- API 场景应自行设置
w.Header().Set("Content-Type", "application/json; charset=utf-8") - 然后手动 write JSON（如
json.NewEncoder(w).Encode(map[string]string{"error": "bad request"})） -
http.Error适合管理后台、调试接口、健康检查等纯 HTTP/HTML 上下文
status 参数传错数字会发生什么？
http.Error 的 status 参数必须是标准 HTTP 状态码（如 http.StatusBadRequest、400），但 Go 不校验它是否合法。传入非法值（如 -1、999、0）会导致：
- Go 1.22+ 会记录 warning 日志（
http: invalid status code 999） - 响应头中仍会写出该数字（
Status: 999 Unknown Status） - 部分反向代理或浏览器可能忽略或降级处理
- 建议始终用
http.常量，避免硬编码数字
例如：http.Error(w, "not found", http.StatusNotFound) 安全；http.Error(w, "not found", 404) 可读性差且易出错。
能否自定义错误页面模板？
不能。原生 http.Error 固定输出格式：
<title>404 Not Found</title><h1>Not Found</h1>。它不接受模板、不支持 i18n、无法注入 CSS 或 JS。
如果需要定制（比如统一错误页、带公司 logo、支持 dark mode），必须绕过 http.Error，自己构造响应：
- 设置状态码：
w.WriteHeader(http.StatusForbidden) - 设置 Content-Type：
w.Header().Set("Content-Type", "text/html; charset=utf-8") - 写入自定义 HTML：
w.Write([]byte("<h1>Access Denied</h1>")) - 或者用
html/template渲染结构化页面
真正容易被忽略的是：哪怕只改一行文案，也得放弃 http.Error —— 它的“标准”是以牺牲灵活性换来的简单性。
