Golang使用errors.Is判断特定错误类型-Golang-PHP中文网

Golang使用errors.Is判断特定错误类型

P粉602998670

发布： 2025-09-11 09:02:01

原创

579人浏览过

errors.Is用于判断错误是否与目标错误相等，可递归解包错误。例如os.Open返回的错误可用errors.Is(err, os.ErrNotExist)判断文件不存在，支持自定义哨兵错误和%w包装，比errors.As更适用于具体错误值的比较，提升错误处理安全性与可读性。

golang使用errors.is判断特定错误类型

在Go语言中，处理错误时经常需要判断一个错误是否是特定类型的错误。从Go 1.13开始，errors.Is 函数被引入，提供了一种更清晰、安全的方式来比较错误，尤其适用于带有错误包装（error wrapping）的场景。

errors.Is 的基本用法

errors.Is 函数用于判断一个错误是否与另一个目标错误相等，它会递归地解包被包装的错误，直到找到匹配的目标错误或无法再解包为止。

函数签名如下：

func Is(err, target error) bool

如果 err 和 target 表示相同的错误，或者 err 是由 target 包装而来，就返回 true。

立即学习“go语言免费学习笔记（深入）”；

示例：

package main

import (
  "errors"
  "fmt"
  "os"
)

func main() {
  _, err := os.Open("non-existent-file.txt")
  if errors.Is(err, os.ErrNotExist) {
    fmt.Println("文件不存在")
  } else if err != nil {
    fmt.Println("其他错误:", err)
  }
}

在这个例子中，即使 os.Open 返回的错误被中间层包装过，errors.Is 依然能正确识别出它是否源自 os.ErrNotExist。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

自定义错误与 errors.Is

你也可以在自己的代码中定义哨兵错误（sentinel errors），并使用 errors.Is 进行判断。

var ErrValidationFailed = errors.New("验证失败")

func validate(input string) error {
  if input == "" {
    return fmt.Errorf("输入为空: %w", ErrValidationFailed)
  }
  return nil
}

func main() {
  err := validate("")
  if errors.Is(err, ErrValidationFailed) {
    fmt.Println("验证出错")
  }
}

使用 %w 格式动词包装错误后，errors.Is 能穿透包装，正确匹配到原始的 ErrValidationFailed 错误。