Go语言如何做自定义HTTP错误页面_Golang ErrorHandler中间件-Golang-PHP中文网

应使用 apphandler 替代标准 http.handler，让 handler 返回 error 并由包装器统一处理 json 错误响应，避免 http.error 破坏结构、goroutine 错误丢失及状态码语义丢失。

go语言如何做自定义http错误页面_golang errorhandler中间件

别用 http.Error 直接返回错误页面，它强制文本/HTML、无法嵌入 code 或 trace_id，会破坏你定的 JSON 错误结构。

为什么自定义错误页面总被忽略或返回 200

常见现象：handler 返回了 errors.New("not found")，但前端收到 200 空响应。根本原因是 Go 的 http.Handler 接口不接受 error 返回值，错误没被任何地方捕获就“消失”了。

标准库 handler 签名是 func(http.ResponseWriter, *http.Request)，没法把 error 向上传递
如果你在 goroutine 里出错（比如 go db.Query()），中间件完全收不到——它只管主请求协程
没做类型断言就直接调 http.Error(w, err.Error(), 500)，会导致非 StatusError 类型的 error 被当成字符串处理，丢失状态码语义

用 `AppHandler` 替换原始 handler 类型

核心是让 handler 自己能返回 error，再由包装器统一处理。这不是加个中间件就行，而是改写 handler 定义方式：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

type AppHandler func(http.ResponseWriter, *http.Request) error

func (fn AppHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    if err := fn(w, r); err != nil {
        switch e := err.(type) {
        case *StatusError:
            w.Header().Set("Content-Type", "application/json; charset=utf-8")
            http.Error(w, fmt.Sprintf(`{"code":%d,"message":"%s"}`, e.Status, html.EscapeString(e.Err.Error())), e.Status)
        default:
            w.Header().Set("Content-Type", "application/json; charset=utf-8")
            http.Error(w, `{"code":500,"message":"internal server error"}`, http.StatusInternalServerError)
        }
        return
    }
}

所有业务 handler 改成返回 error，例如 func home(w http.ResponseWriter, r *http.Request) error { ... }
注册路由时必须用 AppHandler(home) 包一层，否则编译不通过
StatusError 必须用指针接收器实现 Error() 方法，否则类型断言失败

中间件里 recover panic 但别吐堆栈给前端

panic 不等于业务错误，中间件要区分对待：前者需记录日志并返回通用 500，后者应走 StatusError 流程。

中间件中 defer func() { if r := recover(); r != nil { log.Printf("PANIC: %+v", r) ... } }() 是基础，但恢复后不能直接调 http.Error —— 可能已写过 header
更安全的做法是：recover 后设置一个标记，让外层 AppHandler.ServeHTTP 统一响应，避免多次写 response
别在 recover 里调 r.Body.Close() 或读 r.FormValue，此时 r 可能已失效
如果用了 Gin，必须用 gin.RecoveryWithWriter() 并配合 c.AbortWithStatusJSON()，默认 gin.Recovery() 不支持 JSON 响应