Golang错误变量如何定义_Golang公共错误声明模式-Golang-PHP中文网

Golang错误变量如何定义_Golang公共错误声明模式

P粉602998670

发布： 2025-12-05 13:34:02

原创

1007人浏览过

Go中通过var声明公共错误变量，如ErrNotFound，使用fmt.Errorf配合%w包装错误以保留原错误链，支持errors.Is和errors.As判断，自定义错误类型可携带状态码等信息，遵循Err开头、小写描述、复用变量等最佳实践，提升代码可读性和错误处理一致性。

golang错误变量如何定义_golang公共错误声明模式

在Go语言中，错误处理是通过返回值显式处理的，因此定义清晰、可复用的错误变量非常重要。为了提升代码可读性和一致性，Go社区形成了一套公共错误声明的模式。

使用 var 声明公共错误

最常见的方式是在包级别使用 var 块声明错误变量，配合 errors.New 初始化。这些错误通常表示函数可能返回的特定失败情况。

例如：

var (
    ErrNotFound          = errors.New("resource not found")
    ErrInvalidArgument   = errors.New("invalid argument provided")
    ErrUnauthorized      = errors.New("unauthorized access")
    ErrTimeout           = errors.New("operation timed out")
)

登录后复制

这种方式让错误在整个包甚至其他包中都能被引用，调用方可以使用 errors.Is 进行判断。

使用 fmt.Errorf 配合 %w 实现包装错误

当需要附加上下文但又保留原始错误类型时，应使用 fmt.Errorf 并配合 %w 动词进行错误包装。

示例：

if err := readFile(); err != nil {
    return fmt.Errorf("failed to read config: %w", err)
}

登录后复制

这样既保留了底层错误链，又能提供更丰富的上下文信息，同时支持 errors.Is 和 errors.As 的匹配。

图改改

在线修改图片文字

2496

查看详情

自定义错误类型以携带更多信息

对于需要携带额外数据（如状态码、时间戳）的场景，可以定义实现 error 接口的结构体。

例如：

type AppError struct {
    Code    int
    Message string
    Err     error
}

func (e *AppError) Error() string {
    return fmt.Sprintf("[%d] %s: %v", e.Code, e.Message, e.Err)
}

func (e *AppError) Unwrap() error {
    return e.Err
}

登录后复制

这种模式适合构建分层应用中的错误体系，便于中间件统一处理和日志记录。