通过中间件统一捕获错误，提升Go HTTP服务的可维护性：定义返回error的HandlerFunc类型，创建ErrorMiddleware捕获错误并根据自定义错误类型（如NotFoundError、ValidationError）返回对应JSON响应，业务逻辑中直接返回错误，路由注册时用中间件包装，实现错误处理集中化与API响应标准化。
在Golang中构建HTTP服务时，统一处理错误是提升代码可维护性和API一致性的关键。通过中间件捕获路由处理函数中的错误，可以避免在每个handler中重复写错误处理逻辑。
使用中间件统一捕获HTTP错误
Go的HTTP处理函数（http.HandlerFunc）本身不支持返回error，但我们可以封装一个返回error的处理函数类型，并通过中间件来捕获这些错误。
定义一个能返回错误的处理函数类型：
type HandlerFunc func(w http.ResponseWriter, r *http.Request) error
然后编写中间件，将这种函数包装成标准的
http.HandlerFunc，并在发生错误时统一处理： 实现错误捕获中间件：
func ErrorMiddleware(next HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if err := next(w, r); err != nil {
// 可根据错误类型做不同处理
var apiError struct {
Code int `json:"code"`
Message string `json:"message"`
}
switch e := err.(type) {
case *NotFoundError:
apiError.Code = 404
apiError.Message = e.Error()
case *ValidationError:
apiError.Code = 400
apiError.Message = e.Error()
default:
apiError.Code = 500
apiError.Message = "Internal server error"
}
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(apiError.Code)
json.NewEncoder(w).Encode(apiError)
}
}
}
自定义错误类型便于分类处理
定义不同的错误类型，可以让中间件做出更精确的响应。
立即学习“go语言免费学习笔记（深入）”；
type NotFoundError struct{ Message string }
func (e *NotFoundError) Error() string { return e.Message }
type ValidationError struct{ Message string }
func (e *ValidationError) Error() string { return e.Message }
在业务逻辑中直接返回这些错误：
func GetUser(w http.ResponseWriter, r *http.Request) error {
id := r.URL.Query().Get("id")
if id == "" {
return &ValidationError{Message: "missing user id"}
}
// 模拟用户不存在
if id == "999" {
return &NotFoundError{Message: "user not found"}
}
// 正常响应
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(map[string]string{"id": id, "name": "Alice"})
return nil
}
注册路由时使用中间件包装
将自定义的HandlerFunc通过ErrorMiddleware包装后注册到路由。
http.HandleFunc("/user", ErrorMiddleware(GetUser))
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
这样，无论是在参数校验、数据查询还是内部逻辑中返回错误，都会被中间件捕获并转换为统一格式的JSON响应。
基本上就这些。这种方式让错误处理集中化，API响应更规范，也方便后续接入日志、监控等系统。不复杂但容易忽略。
