通过中间件统一处理错误可提升golang Web服务的可维护性。定义ErrorResponse结构体并创建errorMiddleware捕获panic，结合appError类型实现错误分类，在处理器中返回标准化错误响应。使用context传递请求上下文信息便于追踪，或借助gin等框架内置机制简化全局错误处理，避免重复逻辑，实现解耦与集中管理。

在golang中构建Web服务时，错误统一处理是提升代码可维护性和用户体验的关键环节。直接在每个http处理器中散落错误判断和响应逻辑会导致重复代码、难以调试。通过集中式错误处理机制，可以确保所有异常情况以一致格式返回，同时便于日志记录与监控。

使用中间件捕获和处理错误

最常见的方式是编写一个中间件函数，包裹所有的HTTP处理器，捕获其执行过程中发生的panic或显式传递的错误。

定义一个通用的错误响应结构：

type ErrorResponse Struct { Code int `json:”code”` Message String `json:”message”` }

然后创建一个中间件来拦截错误：

立即学习“go语言免费学习笔记（深入）”；

func errorMiddleware(next http.HandlerFunc) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { defer func() { if err := recover(); err != nil { log.printf(“Panic caught: %v”, err) sendErrorResponse(w, http.StatusinternalServerError, “Internal server error”) } }() // 调用实际的处理器 next(w, r) } } func sendErrorResponse(w http.ResponseWriter, statusCode int, message string) { w.Header().Set(“Content-Type”, “application/json”) w.WriteHeader(statusCode) json.NewEncoder(w).Encode(ErrorResponse{ Code: statusCode, Message: message, }) }

将此中间件应用于路由：

http.HandleFunc(“/api/data”, errorMiddleware(handleGetData))

自定义错误类型实现统一控制

通过定义可导出的错误类型，可以让不同层级（如业务逻辑层）返回带有状态码的信息，由HTTP层统一解析。

type AppError struct { Err error Code int } func (e AppError) Error() string { return e.Err.Error() }

在处理器中使用：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

func handleUserGet(w http.ResponseWriter, r *http.Request) { user, err := userService.FindByID(r.URL.Query().Get(“id”)) if err != nil { if errors.Is(err, ErrUserNotFound) { sendErrorResponse(w, http.StatusNotFound, “User not found”) return } sendErrorResponse(w, http.StatusInternalServerError, “Server error”) return } json.NewEncoder(w).Encode(user) }

或者更进一步，在中间件中识别AppError类型：

defer func() { if r := recover(); r != nil { var appErr AppError if ok := errors.As(r, &appErr); ok { sendErrorResponse(w, appErr.Code, appErr.Error()) } else { log.Println(“Panic:”, r) sendErrorResponse(w, http.StatusInternalServerError, “Internal error”) } } }()

结合第三方框架简化处理（如Gin）

如果使用Gin这类流行框架，内置了更优雅的错误处理支持。

r := gin.default() // 全局错误恢复 r.Use(gin.RecoveryWithWriter(gin.DefaultErrorWriter, func(c *gin.Context, err any) { c.JSON(500, ErrorResponse{Code: 500, Message: “Internal error”}) })) // 在处理器中抛出错误 r.GET(“/bad”, func(c *gin.Context) { c.AbortWithError(400, errors.New(“invalid input”)).SetType(gin.ErrorTypePublic) })

Gin还支持中间件中统一处理触发的错误，实现完全集中化管理。

利用context传递请求级错误信息

对于需要跨多个函数调用链传递错误上下文的情况，可通过context附加额外信息，比如请求ID、用户身份等，帮助定位问题。

ctx := context.WithValue(r.Context(), “request_id”, generateID()) r = r.WithContext(ctx)

在日志输出或错误响应中读取这些值，有助于排查特定请求的问题。

基本上就这些。关键是避免在各个handler里写重复的错误判断和响应逻辑，而是通过中间件+统一结构体+合理抽象完成解耦。这样既能保持代码整洁，也方便后续接入监控系统。不复杂但容易忽略细节。