通过中间件统一处理Golang Web服务中的panic和业务错误，可提升稳定性和可维护性。利用defer+recover捕获异常，防止程序崩溃，并结合自定义错误响应结构体统一返回格式，便于前端解析。在net/http中使用装饰器模式包装Handler，在Gin等框架中则利用其内置中间件机制，如c.Next()后读取c.Errors进行错误响应。核心是通过中间件链集中处理各类错误，避免重复代码，确保服务健壮。
在Golang的Web服务开发中，中间件统一错误处理能有效避免重复代码，提升程序健壮性和可维护性。通过中间件捕获处理HTTP请求过程中的panic和自定义错误，可以统一返回格式、记录日志并防止服务崩溃。
使用中间件捕获panic
Go的http handler中一旦发生未处理的panic，会导致整个程序崩溃。中间件可以通过recover机制拦截这些异常。
基本思路是在每个请求开始时设置defer函数调用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 recovered: %v", err)
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
next.ServeHTTP(w, r)
})
}
统一返回错误响应
除了捕获panic，中间件还可以处理业务逻辑中主动抛出的错误，比如数据库查询失败、参数校验不通过等。通过封装响应结构，使所有错误返回格式一致。
立即学习“go语言免费学习笔记（深入）”；
建议定义通用的错误响应结构体，便于前端解析。
示例结构：type ErrorResponse struct {
Error string `json:"error"`
Code int `json:"code"`
}
func ErrorHandlingMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
// 调用实际的handler
err := next(w, r)
if err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(httpStatusFromError(err))
json.NewEncoder(w).Encode(ErrorResponse{
Error: err.Error(),
Code: httpStatusFromError(err),
})
}
}
}
注意：上述写法需要handler返回error类型，而不是直接调用http.Error。
与具体框架结合（如net/http或Gin）
不同Web框架对中间件的支持略有差异，但核心思想相同。
- 原生net/http：使用装饰器模式包装Handler，如上文RecoverMiddleware所示
- Gin框架：使用gin.Context的middleware机制，调用c.Next()后通过c.Errors获取错误
func ErrorHandler() gin.HandlerFunc {
return func(c *gin.Context) {
c.Next() // 处理请求
if len(c.Errors) > 0 {
err := c.Errors[0]
c.JSON(http.StatusInternalServerError, gin.H{
"error": err.Error(),
})
}
}
}
基本上就这些。关键在于利用defer+recover机制捕获运行时异常，并通过中间件链控制响应流程，实现错误集中处理。这样既保证了服务稳定性，又提高了代码复用性。不复杂但容易忽略细节，比如recover必须在defer中调用，否则无效。
