应使用 errors.Is 判断底层错误类型,因其通过递归解包比较错误身份而非脆弱的文本匹配;配合 errors.As 进行类型断言,二者互补处理哨兵错误与自定义错误类型。

用 errors.Is 判断底层错误类型,不是看 error.Error() 文本
很多人一上来就用 strings.Contains(err.Error(), "timeout") 做分类,这非常脆弱:一旦底层库改了错误消息(比如加了前缀、翻译成英文),逻辑就崩了。Go 官方推荐的方式是用 errors.Is 检查是否包装了某个**哨兵错误(sentinel error)** 或实现了特定语义的错误。
比如 net/http 中的超时错误本质是包装了 context.DeadlineExceeded,而 os 包的文件不存在对应 os.ErrNotExist:
if errors.Is(err, os.ErrNotExist) {
log.Println("文件不存在,跳过处理")
} else if errors.Is(err, context.DeadlineExceeded) {
log.Println("请求超时,触发降级")
} else if errors.Is(err, sql.ErrNoRows) {
log.Println("数据库无匹配记录")
}errors.Is 会逐层解包 fmt.Errorf("...: %w", err) 中的 %w,直到找到匹配的哨兵或确认不匹配,所以它依赖的是错误的「身份」,不是字符串。
在 switch 中不能直接 switch err,要配合 errors.Is 或类型断言
Go 的 switch 不支持对 error 接口做值比较(因为接口底层是 (type, value) 对),写 switch err { case os.ErrNotExist: ... } 是语法错误。正确做法分两类:
立即学习“go语言免费学习笔记(深入)”;
- 对已知哨兵错误:用多个
if/else if链,或封装成函数返回分类标签 - 对自定义错误类型:用类型断言 +
switch判断具体类型
例如你定义了多种业务错误:
type ValidationError struct{ Msg string }
type PermissionError struct{ Code int }
func (e ValidationError) Error() string { return "validation failed: " + e.Msg }
func (e PermissionError) Error() string { return "permission denied" }
// 使用时:
switch {
case errors.As(err, &ValidationError{}):
log.Printf("校验失败: %v", err)
case errors.As(err, &PermissionError{}):
log.Printf("权限不足,code=%d", err.(*PermissionError).Code)
default:
log.Printf("未知错误: %v", err)
}
注意:errors.As 第二个参数必须传指针(如 &ValidationError{}),它会把匹配到的错误赋值给该指针指向的变量。
errors.Is 和 errors.As 的性能与兼容性要点
这两个函数从 Go 1.13 引入,如果你项目还跑在 1.12 或更早,不能直接用——得升级或手动实现简单版(不推荐)。实际使用中要注意:
-
errors.Is开销很小,但每次调用都会递归解包,高频路径避免在循环里反复调用同一错误 -
errors.As比errors.Is稍重,因为它要做类型反射判断;如果确定只有一种可能类型,直接用if e, ok := err.(*MyError); ok { ... }更快 - 第三方库若没用
%w包装错误(比如直接fmt.Errorf("xxx: %s", err)),errors.Is和errors.As就失效,此时只能退回到文本匹配或检查Unwrap()方法
别漏掉「错误链末端」和「未包装错误」的兜底处理
真实服务中,错误来源复杂:标准库、中间件、DB 驱动、HTTP 客户端……有些错误根本没被 %w 包装,比如 json.Unmarshal 返回的原生 *json.SyntaxError。这时候 errors.Is(err, xxx) 会返回 false,但你仍可能想按类型处理。
稳妥做法是组合使用:
if errors.Is(err, os.ErrNotExist) {
// 处理
} else if errors.Is(err, context.DeadlineExceeded) {
// 处理
} else if se, ok := err.(*json.SyntaxError); ok {
log.Printf("JSON 解析错在第 %d 行", se.Offset)
} else {
log.Printf("其他错误:%+v", err)
}关键点在于:errors.Is 和类型断言不是互斥的,而是互补的。前者管「语义等价」,后者管「具体类型行为」。漏掉任何一类,都可能让错误静默失败或误分类。










