Golang错误类型断言技巧解析

在Golang实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Golang错误类型断言方法解析》，聊聊，希望可以帮助到正在努力赚钱的你。

errors.As 是判断错误是否为特定类型的推荐方式，它能穿透 %w 包装正确匹配嵌套错误，需传入目标类型指针（如 &pathErr），返回 bool 并赋值；而 errors.Is 用于判断错误链中是否存在特定错误值（如 os.ErrNotExist），需实现 Is 方法。

如何用 errors.As 判断错误是否为特定类型

Go 1.13 引入的 errors.As 是最推荐的方式，它能正确处理嵌套错误（比如被 fmt.Errorf("...: %w", err) 包装过的错误），而传统类型断言 err.(*MyError) 在嵌套时会失败。

常见错误现象：明明错误底层是 *os.PathError，但 err.(*os.PathError) 返回 false —— 很可能因为上游用了 %w 包装。

• 必须传入指向目标类型的指针（如 &target），不是类型本身
• 返回 bool 表示是否成功匹配，匹配后目标变量会被赋值
• 对自定义错误类型，只要实现了 error 接口，就能被 errors.As 检测

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    log.Printf("文件路径错误: %s", pathErr.Path)
}

什么时候该用 errors.Is 而不是类型断言

errors.Is 用于判断错误链中是否存在某个**特定错误值**（比如 os.ErrNotExist），而不是类型。它和 errors.As 解决的是不同问题。

典型场景：你想知道一个 I/O 错误是不是“文件不存在”，而不是关心它是不是 *os.PathError —— 因为可能是 os.ErrNotExist 本身，也可能是被包装过的 *os.PathError，甚至第三方库返回的等价错误。

• errors.Is(err, os.ErrNotExist) 会逐层展开 Unwrap() 并比较值相等
• 不能用它来区分不同结构体类型（比如 *MyError vs *OtherError）
• 自定义错误若想支持 errors.Is，需实现 Is(target error) bool 方法

if errors.Is(err, os.ErrNotExist) {
    // 处理文件不存在逻辑
}

直接类型断言 err.(*MyError) 的适用边界

仅在你**完全确定错误未被包装**、且来自可信内部调用时可用。例如：你自己写的函数明确返回 &MyError{...}，且调用方没用 %w 再包装。

一旦涉及标准库、第三方包或任意中间层的错误包装，这种断言大概率失效。很多新手在这里卡住，反复检查类型名却忽略包装层级。

• 语法是 v, ok := err.(*MyError)，不是 err.(*MyError) 单独使用
• 如果 ok == false，v 是 nil 指针，直接解引用会 panic
• 无法穿透 fmt.Errorf("wrap: %w", err) 或 errors.Join 等多错误结构

v, ok := err.(*MyError)
if ok {
    // 安全使用 v
}

自定义错误类型要支持两种判断，得同时实现两个方法

如果你希望用户既能用 errors.As 断言类型，又能用 errors.Is 判断等价性，你的错误类型需要同时满足：

• 实现 error 接口（必须）
• 实现 Unwrap() error（让 errors.Is 和 errors.As 可以递归检查）
• 实现 Is(target error) bool（控制 errors.Is 的匹配逻辑）

注意：不要在 Unwrap() 中无条件返回 nil，否则 errors.As 无法向下查找；也不要让 Is() 做过于宽松的匹配，否则会误判。

type MyError struct {
    Msg  string
    Code int
    Err  error // 可选的底层错误
}

func (e *MyError) Error() string { return e.Msg }
func (e *MyError) Unwrap() error { return e.Err }
func (e *MyError) Is(target error) bool {
    _, ok := target.(*MyError)
    return ok && e.Code == target.(*MyError).Code
}

今天关于《Golang错误类型断言技巧解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！