如何在Golang中实现简单的错误统一处理_Golang错误处理项目实战汇总_技术教程

通过自定义AppError结构体封装错误，提供工厂函数生成标准错误，结合中间件统一捕获并响应JSON格式错误信息，同时集成日志记录与追踪，实现Go项目中一致、可观测的错误处理体系。

在Go语言开发中，错误处理是日常编码的重要部分。虽然Go没有异常机制，而是通过返回error类型来传递错误信息，但如果不加以规范，项目中的错误处理很容易变得杂乱无章。实现统一的错误处理机制，不仅能提升代码可读性，还能增强系统的可观测性和维护性。

定义统一的错误结构

为了便于管理和响应，建议自定义一个结构体来封装错误信息，包含状态码、消息、错误详情等字段。

示例： ```go type AppError struct { Code int `json:"code"` Message string `json:"message"` Detail string `json:"detail,omitempty"` }

func (e *AppError) Error() string { return e.Message }

这样可以在HTTP响应中直接序列化为JSON格式，方便前端或调用方理解。

封装错误生成函数
为了避免重复创建错误实例，可以提供一组工厂函数来快速生成常见错误。
```go
func NewBadRequestError(message string) *AppError {
    return &AppError{
        Code:    400,
        Message: message,
    }
}

func NewNotFoundError(message string) *AppError {
    return &AppError{
        Code:    404,
        Message: message,
    }
}

func NewInternalError() *AppError {
    return &AppError{
        Code:    500,
        Message: "内部服务器错误",
        Detail:  "系统发生未知错误",
    }
}

使用时简洁明了：

```go if user == nil { return nil, NewNotFoundError("用户不存在") } ```

中间件统一捕获和响应错误

在Web服务中（如使用Gin或net/http），可以通过中间件拦截处理器返回的错误，并统一输出格式。

以Gin为例： ```go func ErrorHandler() gin.HandlerFunc { return func(c *gin.Context) { c.Next() // 执行后续处理

    if len(c.Errors) > 0 {
        err := c.Errors[0].Err
        var appErr *AppError
        if errors.As(err, &appErr) {
            c.JSON(appErr.Code, map[string]interface{}{
                "code":    appErr.Code,
                "message": appErr.Message,
                "detail":  appErr.Detail,
            })
        } else {
            // 未预期的错误，返回500
            internal := NewInternalError()
            c.JSON(500, internal)
        }
        c.Abort()
    }
}

}

控制器中只需关注业务逻辑与错误返回：
```go
func GetUser(c *gin.Context) error {
    id := c.Param("id")
    user, err := userService.FindByID(id)
    if err != nil {
        return NewNotFoundError("无法找到该用户")
    }
    c.JSON(200, user)
    return nil
}

注意： Gin原生不支持返回error中断流程，需结合上下文自行设计返回机制，或使用第三方包辅助。