Go中判断错误类型应按场景选择:精确匹配未包装错误用类型断言;检查错误链中是否存在某类型用errors.As;判断是否等于哨兵错误用errors.Is。

在 Go 中判断错误类型,核心是区分“是否为某类错误”和“是否包含某类错误”。类型断言适合精确匹配具体错误类型(如 *os.PathError),而 errors.As 更适用于检查错误链中是否存在某个目标类型的错误(支持包装错误,如用 fmt.Errorf("xxx: %w", err) 包装的情况)。
用类型断言判断具体错误类型
当明确知道错误变量可能直接是某个具体类型(未被包装)时,可用类型断言:
- 语法为
err.(*os.PathError)或更安全的双返回值形式:if pe, ok := err.(*os.PathError); ok { ... } - 只对**最外层错误**生效,若错误被
%w包装过(如fmt.Errorf("open failed: %w", pe)),断言会失败 - 适用于标准库中常见错误类型,例如:
*os.PathError、*net.OpError、*exec.ExitError
用 errors.As 检查错误链中的目标类型
errors.As 会沿着错误链(通过 Unwrap())逐层查找,只要某一层是目标类型或实现了该接口,就返回 true:
- 使用方式:
var pe *os.PathError; if errors.As(err, &pe) { ... }(注意传入指针地址) - 自动处理多层包装,比如
fmt.Errorf("read: %w", fmt.Errorf("io: %w", pe))也能成功匹配*os.PathError - 也支持接口类型,例如检查是否实现了
interface{ Timeout() bool }
errors.Is 用于判断是否为特定错误值
如果要判断错误是否等于某个预定义的错误变量(如 os.ErrNotExist),应使用 errors.Is:
立即学习“go语言免费学习笔记(深入)”;
if errors.Is(err, os.ErrNotExist) { ... }- 它同样遍历错误链,比较每一层是否
==目标值,适合哨兵错误(sentinel errors) - 不要用
==直接比较,因为包装后的错误地址不同
实际使用建议
优先按场景选择:
- 想确认是否是某个自定义错误结构体?→ 用
errors.As - 想确认是否等于某个全局错误变量(如
sql.ErrNoRows)?→ 用errors.Is - 确定错误没被包装且需快速判断?→ 类型断言可读性高,但不够健壮
- 写公共库或处理用户传入的错误时,一律推荐
errors.As和errors.Is










