统一错误处理中间件可防止Golang服务因panic崩溃，并确保错误响应格式一致。通过RecoverMiddleware捕获panic并记录堆栈，结合ErrorResponse结构化输出，实现标准化JSON错误返回。业务错误通过自定义error类型在ErrorHandler中间件中映射为对应HTTP状态码，提升可维护性。在Gin等框架中可集成CustomRecovery实现全局控制，从而将错误处理与业务逻辑分离，保障服务稳定性和API一致性。
在Golang Web开发中，统一错误处理中间件能有效避免重复的错误捕获逻辑，提升代码可维护性。尤其在HTTP服务中，未被捕获的panic会导致服务崩溃，而分散的错误处理会让响应格式不一致。通过中间件机制，我们可以集中处理异常和错误返回。
统一错误恢复：防止程序崩溃
Go的HTTP服务一旦发生未捕获的panic，当前goroutine会终止，但主服务可能继续运行，这容易导致不稳定状态。使用recover可以拦截panic并安全地返回错误响应。
实现一个基础的recover中间件：
func RecoverMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
// 记录堆栈信息便于排查
log.Printf("Panic: %v\n", err)
for i := 1; ; i++ {
_, file, line, ok := runtime.Caller(i)
if !ok {
break
}
log.Printf(" %s:%d", file, line)
}
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
next.ServeHTTP(w, r)
})
}
标准化错误响应格式
实际项目中，通常需要返回结构化的错误信息，而不是简单的字符串。可以定义统一的响应结构：
立即学习“go语言免费学习笔记（深入）”；
type ErrorResponse struct {
Code int `json:"code"`
Message string `json:"message"`
}
func writeError(w http.ResponseWriter, code int, message string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(code)
json.NewEncoder(w).Encode(ErrorResponse{
Code: code,
Message: message,
})
}
在中间件中调用writeError替代http.Error，使所有错误响应保持一致。
拦截业务错误并转换为HTTP响应
除了panic，业务逻辑中的error也需要统一处理。可以在handler内部约定返回error，在中间件中判断并处理：
type handlerFunc func(http.ResponseWriter, *http.Request) error
func ErrorHandler(h handlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if err := h(w, r); err != nil {
switch e := err.(type) {
case *ValidationError:
writeError(w, http.StatusBadRequest, e.Error())
case *NotFoundError:
writeError(w, http.StatusNotFound, e.Error())
default:
log.Printf("Unexpected error: %v", err)
writeError(w, http.StatusInternalServerError, "Server error")
}
}
}
}
这样业务函数可以直接返回不同类型的错误，由中间件自动映射到对应HTTP状态码。
集成到主流框架（以Gin为例）
Gin框架本身支持全局recovery中间件，并允许自定义处理函数：
r := gin.Default()
r.Use(gin.CustomRecovery(func(c *gin.Context, recovered interface{}) {
if recovered != nil {
log.Printf("Panic recovered: %v", recovered)
c.JSON(500, gin.H{"code": 500, "message": "Internal Server Error"})
}
}))
结合自定义error类型与Gin的AbortWithError，也能实现细粒度控制。
基本上就这些。关键在于将错误处理从具体业务中剥离，通过中间件统一拦截、记录和响应，既能保障服务稳定性，又能提供一致的API体验。
