定义统一错误类型AppError，通过中间件集中处理error和panic。使用HandlerFunc返回error，defer recover捕获异常，结合context传递上下文信息，实现优雅错误管理。
在Go语言的Web开发中，中间件是处理请求前后的逻辑（如日志、认证、权限校验）的重要组件。当多个Handler中出现错误时，如果每个函数都单独处理error，会导致代码重复且难以维护。因此，在中间件中集中处理error是一种更优雅的做法。
统一错误类型设计
为了便于中间件识别和处理错误，建议定义一个统一的错误接口或结构体，让业务逻辑返回标准化的错误信息。
例如：
type AppError struct {
Code int
Msg string
}
func (e AppError) Error() string {
return e.Msg
}
这样，Handler可以返回 AppError{400, "参数错误"}，中间件能根据 Code 判断是客户端错误还是服务器错误。
立即学习“go语言免费学习笔记（深入）”；
使用中间件捕获 panic 和 error
通过 defer 和 recover 可以在中间件中捕获未处理的 panic，并将其转换为 HTTP 响应。同时，可以封装 Handler 函数类型，使其支持返回 error。
定义可返回 error 的 Handler 类型：
type HandlerFunc func(w http.ResponseWriter, r *http.Request) error
中间件包装该类型并处理错误：
func ErrorMiddleware(next HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
log.Printf("Panic: %v", err)
http.Error(w, "Internal Server Error", 500)
}
}()
if err := next(w, r); err != nil {
if appErr, ok := err.(AppError); ok {
http.Error(w, appErr.Msg, appErr.Code)
} else {
log.Printf("Unexpected error: %v", err)
http.Error(w, "Internal Server Error", 500)
}
}
}
}
在业务Handler中返回错误
使用封装后的 HandlerFunc，可以在业务逻辑中直接 return 错误，由中间件统一处理。
func GetUser(w http.ResponseWriter, r *http.Request) error {
id := r.URL.Query().Get("id")
if id == "" {
return AppError{400, "Missing user id"}
}
// ... 处理业务逻辑
return nil
}
注册路由时使用中间件包装：
http.HandleFunc("/user", ErrorMiddleware(GetUser))
结合 context 传递错误上下文（可选）
对于需要记录更多错误信息（如 trace ID）的场景，可通过 context 向下传递上下文，并在中间件中提取附加信息。
比如在中间件中生成 requestID，出错时一并打印，有助于排查问题。
基本上就这些。通过自定义错误类型、封装Handler、使用中间件recover和拦截error，Golang可以实现清晰的错误管理机制，避免散落在各处的 if err != nil，提升代码可读性和维护性。不复杂但容易忽略。
