推荐使用 errors.Is 和 errors.As 判断错误类型:errors.Is(err, target) 沿错误链检查是否等于哨兵错误(如 os.ErrNotExist);errors.As(err, &target) 提取第一个匹配的底层错误值(如 *os.PathError)。

在 Go 中判断错误类型,推荐使用 errors.Is 和 errors.As,它们是 Go 1.13 引入的标准方式,能安全、准确地处理包装错误(wrapped errors),替代过去容易出错的类型断言或 == 比较。
用 errors.Is 判断是否为某个具体错误
errors.Is(err, target) 会沿着错误链向上检查,看是否有某一层错误与 target 相等(基于 Is() 方法或值比较)。适合判断是否发生了某个预定义的错误(如 io.EOF、自定义的 sentinel error)。
- 必须使用哨兵错误(sentinel error),例如
var ErrNotFound = errors.New("not found"),而不是每次errors.New("not found")新建 - 支持标准库中已实现
Is()方法的错误,比如os.ErrNotExist、io.EOF - 示例:if errors.Is(err, os.ErrNotExist) { /* 处理文件不存在 */ }
用 errors.As 提取底层错误值或结构体
errors.As(err, &target) 尝试将错误链中第一个匹配的错误赋值给 target(需是指针)。适合需要访问错误内部字段或调用其方法的场景,比如获取 *os.PathError 的 Path 或 Err 字段。
-
target必须是指向接口或具体类型的指针,例如*os.PathError、*MyCustomError - 它只解包一层匹配项,不遍历全部;若错误链中有多个同类型错误,只取最内层(最先被包装的那个)
- 示例:var pathErr *os.PathError
if errors.As(err, &pathErr) { fmt.Println("路径错误:", pathErr.Path) }
避免常见误区
直接用 err == someErr 只能匹配最外层错误,对 fmt.Errorf("wrap: %w", origErr) 这类包装错误失效;而类型断言 err.(*MyErr) 无法穿透多层包装,且 panic 风险高。
立即学习“go语言免费学习笔记(深入)”;
- 不要用
reflect.TypeOf(err) == reflect.TypeOf(&MyErr{})—— 不安全、不标准、无法处理包装 - 不要在未确认类型前对
err做强制类型转换 - 自定义错误建议实现
Unwrap() error(如果可包装)和Is(error) bool(如果需参与errors.Is判断)
组合使用更健壮
实际中常先用 errors.Is 做粗粒度判断(是否是某类业务错误),再用 errors.As 提取细节进一步处理。
- 例如:先
errors.Is(err, ErrValidationFailed)判断是否校验失败,再errors.As(err, &validationErr)获取具体哪个字段出错 - 注意顺序:先
Is再As更高效,因为Is通常更快;若只需提取信息,可直接As










