errors.Is 用于递归判断错误是否等于某预定义值,errors.As 用于安全提取包装链中特定类型的错误实例;二者均依赖 Unwrap 方法,要求自定义错误导出字段且接收者为指针。
errors.Is 和 errors.As 是 Go 1.13 引入的错误判断核心工具,用于替代过去脆弱的 == 或类型断言。它们能正确处理包装错误(如 fmt.Errorf("wrap: %w", err)),是现代 Go 错误处理的标配。
什么时候该用 errors.Is 而不是 ==
当你需要判断一个错误是否「等于」某个预定义的错误值(比如 io.EOF、自定义的 ErrNotFound),且该错误可能被多层 %w 包装时,必须用 errors.Is。
-
==只比较最外层错误指针或值,一旦被fmt.Errorf("failed: %w", err)包裹就失效 -
errors.Is(err, io.EOF)会递归解包,直到找到匹配的底层错误 - 常见误用:对自定义错误使用
==判断,但实际返回的是fmt.Errorf("xxx: %w", myErr)
示例:
var ErrNotFound = errors.New("not found")
func find() error {
return fmt.Errorf("in db: %w", ErrNotFound) // 被包装
}
err := find()
fmt.Println(errors.Is(err, ErrNotFound)) // true
fmt.Println(err == ErrNotFound) // false
为什么 errors.As 比直接类型断言更安全
errors.As(err, &target) 用于提取包装链中某个特定类型的错误实例(比如提取 *os.PathError 或自定义结构体),它比 if e, ok := err.(*MyError) 更健壮。