0

0

errors.Is / errors.As / errors.Join / %w 全用法汇总

冷漠man

冷漠man

发布时间:2026-01-19 13:17:29

|

589人浏览过

|

来源于php中文网

原创

Go 1.13 错误处理新工具核心是支持错误链的查询、转换与组合:errors.Is 判断链中是否存在目标错误,errors.As 提取指定类型错误,errors.Join 合并多错误,%w 是唯一推荐的包装方式。

errors.is / errors.as / errors.join / %w 全用法汇总

Go 1.13 引入的错误处理新工具,核心是让错误链(error chain)可查、可转、可组合。它们不是替代 ==errors.New,而是解决“被包装过的错误怎么判断类型/提取原因”这个长期痛点。

errors.Is:判断错误链中是否存在某个目标错误

用于检查一个错误是否等于(或其底层包装链中包含)某个已知错误值(常量或变量),支持多层包装。

  • 底层调用 Unwrap() 逐层展开,直到匹配到目标错误,或返回 nil
  • 只适用于判断 errors.Newfmt.Errorf%w 包装的错误,或实现了 Is(error) bool 方法的自定义错误
  • 不适用于类型断言(比如想看是不是 *os.PathError,该用 errors.As

示例:

TalkMe
TalkMe

与AI语伴聊天,练习外语口语

下载
```go
err := fmt.Errorf("failed to read config: %w", os.ErrNotExist)
if errors.Is(err, os.ErrNotExist) {
  log.Println("config file missing") // ✅ 匹配成功
}
```

errors.As:从错误链中提取特定类型的错误实例

用于向下转型(type assertion),把错误链里第一个匹配指定类型的错误赋值给目标变量,适合获取底层具体错误信息(如路径、errno 等)。

  • 同样递归调用 Unwrap(),找到第一个满足 target 类型的错误并赋值
  • target 必须是指针(如 *os.PathError),否则 panic
  • 返回 bool 表示是否成功提取

示例:

```go
err := fmt.Errorf("read failed: %w", &os.PathError{Op: "open", Path: "/etc/config.json", Err: syscall.ENOENT})
var pathErr *os.PathError
if errors.As(err, &pathErr) {
  log.Printf("op=%s, path=%s", pathErr.Op, pathErr.Path) // op=open, path=/etc/config.json
}
```

errors.Join:合并多个错误为一个可遍历的复合错误

将零个或多个错误打包成一个 interface{ Unwrap() []error } 类型的错误,便于统一返回(尤其在并发或批量操作中)。

  • 返回的错误调用 Unwrap() 会返回所有子错误切片(顺序与传入一致)
  • 它本身不实现 Error() 方法,但标准库fmt 包对其实现了友好格式化(如 fmt.Errorf("failed: %w", errors.Join(e1,e2))
  • 注意:不能直接用 errors.Iserrors.AsJoin 结果上查单个子错误——需先 Unwrap() 再逐个查,或用循环配合 errors.Is/As

示例:

```go
e1 := errors.New("failed to connect")
e2 := errors.New("timeout")
multiErr := errors.Join(e1, e2)

// 手动检查每个子错误
for _, e := range multiErr.(interface{ Unwrap() []error }).Unwrap() {
  if errors.Is(e, context.DeadlineExceeded) { /* ... */ }
}
```

%w:格式化时包装错误的标准方式(必须搭配 fmt.Errorf)

fmt.Errorf 中使用 %w 动词,表示“将后面的 error 值包装进新错误”,这是构建可追溯错误链的唯一推荐方式。

  • %w 包装的错误可通过 errors.Unwrap()errors.Iserrors.As 向下访问
  • 只能用一次(一个 fmt.Errorf 中最多一个 %w),且必须是最后一个参数
  • 不用 %w 而用 %s 或字符串拼接,会导致错误链断裂,无法用 Is/As 追溯

示例:

```go
// ✅ 正确:保留错误链
err := fmt.Errorf("loading module %q failed: %w", name, innerErr)

// ❌ 错误:丢失原始错误信息
err := fmt.Errorf("loading module %q failed: %s", name, innerErr.Error())
```

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

750

2023.08.22

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

288

2023.10.25

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

3

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号