Go错误处理需结合自定义类型与错误包装:用%w保留原始错误,errors.Is判断哨兵错误,errors.As安全提取自定义错误,避免==比较。

在 Go 中,errors 包提供了创建和处理错误的基础能力,但真正灵活、可维护的错误处理往往需要结合自定义错误类型和更丰富的上下文信息。Go 1.13 引入的错误包装(`%w`)和 `errors.Is`/`errors.As` 等函数,让错误链和类型断言变得更可靠。
使用 errors.New 和 fmt.Errorf 创建基础错误
最简单的方式是用 errors.New 创建静态字符串错误,或用 fmt.Errorf 动态拼接带变量的信息:
err := errors.New("failed to open config file")err := fmt.Errorf("failed to parse %s: %v", filename, errParse)
注意:直接拼接字符串会丢失原始错误,如需保留底层原因,应使用 %w 动词进行包装:
err := fmt.Errorf("loading config: %w", os.Open(filename))
定义自定义错误类型(实现 error 接口)
当需要区分错误种类、携带结构化字段(如错误码、重试标志、HTTP 状态码),可定义结构体并实现 Error() string 方法:
立即学习“go语言免费学习笔记(深入)”;
type ValidationError struct {
Field string
Message string
Code int
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("validation failed on %s: %s", e.Field, e.Message)
}
这样既能提供可读信息,又支持类型断言判断错误类型:
if ve, ok := err.(*ValidationError); ok { /* 处理校验错误 */ }
用 errors.As 安全提取自定义错误(支持错误链)
相比类型断言,errors.As 能穿透多层包装找到目标错误类型,更健壮:
var ve *ValidationError
if errors.As(err, &ve) {
log.Printf("Validation error on %s, code: %d", ve.Field, ve.Code)
}它会从最内层错误开始逐级检查,直到匹配或遍历完错误链。
用 errors.Is 判断是否为特定错误(常用于哨兵错误)
对于预定义的全局错误变量(哨兵错误),推荐用 errors.Is 判断相等性,它同样支持错误链:
var ErrNotFound = errors.New("not found")
// 即使 err 是 fmt.Errorf("user not found: %w", ErrNotFound),仍能匹配
if errors.Is(err, ErrNotFound) {
return http.StatusNotFound
}
避免直接用 == 比较,因为包装后的错误地址已变。










