通过中间件统一处理错误可提升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() }在处理器中使用：
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里写重复的错误判断和响应逻辑，而是通过中间件+统一结构体+合理抽象完成解耦。这样既能保持代码整洁，也方便后续接入监控系统。不复杂但容易忽略细节。
