Golang实战项目如何进行基本的错误包装和处理-Golang-PHP中文网

Golang实战项目如何进行基本的错误包装和处理

P粉602998670

发布： 2025-08-30 09:13:01

原创

530人浏览过

使用%w包装错误并配合errors.Is和errors.As进行判断，可有效维护错误链；自定义AppError结构体携带上下文信息，并统一错误响应格式与日志记录，提升系统可维护性。

golang实战项目如何进行基本的错误包装和处理

在Go语言实战项目中，错误处理是保证程序健壮性的关键环节。Go通过返回

error

登录后复制

类型来显式处理异常，而不是使用抛出异常的机制。合理的错误包装和处理能帮助开发者快速定位问题，提升系统的可维护性。

使用 errors.Is 和 errors.As 进行错误判断

在调用链较深的项目中，原始错误可能被多次包装。直接比较错误值会失败，因此应使用标准库提供的工具函数进行判断。

Go 1.13 引入了

fmt.Errorf

登录后复制

的

%w

登录后复制

动词来包装错误，同时保留原始错误信息。之后可通过

errors.Is

登录后复制

和

errors.As

登录后复制

进行断言和类型提取。

```
errors.Is(err, target)
```
登录后复制
：判断
```
err
```
登录后复制
是否与目标错误相等（包括被包装的情况）
```
errors.As(err, &target)
```
登录后复制
：判断
```
err
```
登录后复制
链中是否包含指定类型的错误，并赋值

示例：

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

<span style="color:#555">// 数据库查询失败模拟</span>
if err != nil {
    return fmt.Errorf("failed to query user: %w", err)
}

<span style="color:#555">// 上层调用中判断具体错误类型</span>
if errors.Is(err, sql.ErrNoRows) {
    log.Println("用户不存在")
} else if errors.As(err, &customErr) {
    log.Printf("自定义错误: %v", customErr)
}

登录后复制

自定义错误类型并实现 Error 方法

对于业务逻辑中的特定错误，建议定义结构体错误类型，携带更多上下文信息。

通过实现

Error()

登录后复制

方法，可以控制错误的输出格式，同时保留堆栈、时间、请求ID等调试信息。

Softr Studio

最简单的无代码web开发平台

查看详情

type AppError struct {
    Code    int
    Message string
    Err     error
    Time    time.Time
}

func (e *AppError) Error() string {
    return fmt.Sprintf("[%d] %s at %s", e.Code, e.Message, e.Time.Format(time.Stamp))
}

func NewAppError(code int, message string, err error) *AppError {
    return &AppError{
        Code:    code,
        Message: message,
        Err:     err,
        Time:    time.Now(),
    }
}

登录后复制

使用时可包装底层错误：

if err != nil {
    return nil, NewAppError(4001, "用户认证失败", err)
}

登录后复制

统一错误响应与日志记录

在Web服务中，建议将错误统一转换为标准响应格式，避免敏感信息泄露，同时便于前端处理。

结合中间件或拦截器，在返回响应前对错误进行处理。

func ErrorResponse(err error) map[string]interface{} {
    if appErr, ok := err.(*AppError); ok {
        return map[string]interface{}{
            "code":  appErr.Code,
            "msg":   appErr.Message,
            "time":  appErr.Time.Unix(),
        }
    }
    <span style="color:#555">// 未知错误统一处理</span>
    return map[string]interface{}{
        "code": 5000,
        "msg":  "系统内部错误",
    }
}

登录后复制

同时，记录错误日志时应包含完整堆栈（可借助第三方库如