中间件 middleware/error.go
package middlewareimport ("net/http""github.com/gin-gonic/gin"
)// ErrorHandler 全局错误处理中间件
func ErrorHandler() gin.HandlerFunc {return func(c *gin.Context) {// 1. 继续执行后续的 Handler 函数c.Next()// 2. 检查是否有错误发生if len(c.Errors) > 0 {err := c.Errors.Last().Err// 3. 根据错误类型，返回不同的 HTTP 状态码和 JSON 格式switch e := err.(type) {case *MyBusinessError: // 自定义业务错误c.JSON(http.StatusBadRequest, gin.H{"code": e.Code,"message": e.Message,})default: // 其他未知错误c.JSON(http.StatusInternalServerError, gin.H{"code": 500,"message": "服务器内部错误",})}// 4. 终止后续处理c.Abort()}}
}// 自定义业务错误示例
type MyBusinessError struct {Code intMessage string
}func (e *MyBusinessError) Error() string {return e.Message
}
使用示例
func main() {r := gin.Default()// 在路由之前注册全局错误处理中间件r.Use(middleware.ErrorHandler())// ... 其他路由r.GET("/test", func(c *gin.Context) {// 假设发生了一个业务错误err := &MyBusinessError{Code: 1002, Message: "参数无效"}// 使用 c.Error(err) 将错误交给中间件处理，Handler 内部无需关心响应细节c.Error(err)})
}
