本文介绍如何将返回 error 的自定义 HandlerFunc 封装为标准 http.Handler，使其兼容 Go 标准库的 http.ServeHTTP 接口，并支持链式中间件包装，解决类型不匹配与方法签名错误问题。
本文介绍如何将返回 error 的自定义 `handlerfunc` 封装为标准 `http.handler`，使其兼容 go 标准库的 `http.servehttp` 接口，并支持链式中间件包装，解决类型不匹配与方法签名错误问题。
在 Go 的 HTTP 生态中，标准 http.Handler 要求实现 ServeHTTP(http.ResponseWriter, *http.Request) 方法（无返回值），但许多现代 Web 模式（如错误可传播的 handler）倾向于使用返回 error 的函数签名：
func(w http.ResponseWriter, r *http.Request) error
直接将该函数赋给 http.Handler 会导致编译错误——因为类型不匹配。解决方案是定义一个函数类型并为其实现 ServeHTTP 方法，从而桥接语义差异。
✅ 正确封装方式
type HandlerFunc func(http.ResponseWriter, *http.Request) error
// ServeHTTP 实现标准 http.Handler 接口
func (f HandlerFunc) ServeHTTP(w http.ResponseWriter, r *http.Request) {
if err := f(w, r); err != nil {
// 统一错误处理：例如写入 500、记录日志等
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
log.Printf("handler error: %v", err)
}
}
该设计简洁且符合 Go 惯例（类似 net/http 中的 http.HandlerFunc）。现在你可以直接用函数字面量或命名函数初始化 handler：
func home(w http.ResponseWriter, r *http.Request) error {
_, err := w.Write([]byte("Hello, World!"))
return err // 可返回底层 I/O 错误
}
func main() {
http.Handle("/", HandlerFunc(home))
log.Println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}
? 支持中间件包装（Wrap）
基于上述 HandlerFunc 类型，中间件可自然地以高阶函数形式实现：
// 日志中间件
func withLogging(next HandlerFunc) HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) error {
log.Printf("Started %s %s", r.Method, r.URL.Path)
err := next(w, r)
log.Printf("Completed %s %s", r.Method, r.URL.Path)
return err
}
}
// 错误恢复中间件（防止 panic）
func withRecovery(next HandlerFunc) HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) error {
defer func() {
if rec := recover(); rec != nil {
http.Error(w, "Internal Error", http.StatusInternalServerError)
log.Printf("Panic recovered: %v", rec)
}
}()
return next(w, r)
}
}
// 组合使用
func main() {
h := HandlerFunc(home)
h = withLogging(h)
h = withRecovery(h)
http.Handle("/", h)
http.ListenAndServe(":8080", nil)
}
⚠️ 注意事项
- 原问题中 CustomHandler 结构体设计存在冗余：若仅需封装函数，无需额外 struct；若需携带状态（如配置、DB 连接），才应保留结构体，但 ServeHTTP 实现需修正拼写（Handeler → Handler，ServerHttp → ServeHTTP）及逻辑（调用 c.HandlerFunc(...) 而非 c.Handler.ServerHTTP(...)）。
- http.Error 会自动设置状态码并终止响应；若需更精细控制（如自定义错误页面），请手动写入 header 与 body。
- 中间件顺序很重要：越靠前的中间件越早执行（请求阶段），也越晚执行（响应/错误处理阶段）。
通过这一封装，你既能享受函数式 handler 的简洁性与错误传播能力，又能无缝集成 Go 标准库和主流中间件生态。
