本文介绍如何在使用 julienschmidt/httprouter 时，通过自定义函数类型与闭包转换，实现类似标准 http.Handler 的统一错误处理机制，避免在每个路由处理器中重复编写 if err != nil { http.Error(...) } 逻辑。
本文介绍如何在使用 julienschmidt/httprouter 时，通过自定义函数类型与闭包转换，实现类似标准 `http.handler` 的统一错误处理机制，避免在每个路由处理器中重复编写 `if err != nil { http.error(...) }` 逻辑。
julienschmidt/httprouter 是一个高性能、支持路径参数（如 /user/:id）的 Go HTTP 路由器，其处理器签名是：
type Handler func(http.ResponseWriter, *http.Request, Params)
与标准库 http.Handler 接口不同，它不直接支持返回错误——这意味着开发者常需在每个 handler 内手动检查错误并调用 http.Error，导致大量重复代码，违背 DRY 原则。
解决方案是引入一个可组合的错误感知处理器类型 ErrHandle，并提供安全转换方法 ToHandle()，将带错误返回的逻辑自动包装为 router 所需的无返回值 Handler：
package main
import (
"net/http"
"github.com/julienschmidt/httprouter"
)
// ErrHandle 表示可返回 error 的路由处理器
type ErrHandle func(http.ResponseWriter, *http.Request, httprouter.Params) error
// ToHandle 将 ErrHandle 安全转换为 httprouter.Handler
func (eh ErrHandle) ToHandle() httprouter.Handle {
return func(w http.ResponseWriter, r *http.Request, p httprouter.Params) {
if err := eh(w, r, p); err != nil {
// 生产环境建议使用结构化错误响应，而非裸 err.Error()
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}
}
使用时，你只需编写符合 ErrHandle 签名的业务逻辑函数，并通过 .ToHandle() 注册到 router：
func getUser(w http.ResponseWriter, r *http.Request, p httprouter.Params) error {
userID := p.ByName("id")
if userID == "" {
return fmt.Errorf("missing user ID")
}
// 模拟 DB 查询
user, err := findUserByID(userID)
if err != nil {
return fmt.Errorf("failed to fetch user: %w", err)
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)
return nil // 显式成功，无错误
}
func main() {
router := httprouter.New()
router.GET("/user/:id", (*ErrHandle)(&getUser).ToHandle())
// ✅ 等价写法（更简洁）：
// router.GET("/user/:id", ErrHandle(getUser).ToHandle())
http.ListenAndServe(":8080", router)
}
⚠️ 注意事项：
- http.Error 默认返回纯文本响应（text/plain），生产系统建议统一返回 JSON 错误（如 {"error": "..."}）并设置正确 Content-Type 和状态码；
- 可进一步扩展 ErrHandle 以支持中间件链（如日志、认证）、上下文超时或自定义错误映射（如将 sql.ErrNoRows 映射为 404）；
- 若需差异化状态码，可将 error 类型替换为自定义错误接口（如 interface{ StatusCode() int }），并在 ToHandle 中动态解析。
这种封装保持了 httprouter 的轻量与性能优势，同时赋予其媲美 net/http 标准错误处理的表达力与可维护性——无需修改路由核心，仅靠类型抽象与闭包即可达成工程级复用。
