Go 1.20 的 errors.Join 提供标准、语义清晰的多错误合并机制,构建可遍历、可检查、可展开的错误树,适用于并发失败汇总、多步骤操作错误收集及需保留原始类型和上下文的场景。

Go 1.20 引入了 errors.Join,让多错误合并变得简洁、标准且语义清晰。它不是简单拼接字符串,而是构建一个可遍历、可检查、可展开的错误树,特别适合在并发、批量操作或嵌套调用中汇总多个失败原因。
什么时候该用 errors.Join?
当你遇到以下情况时,errors.Join 比手动拼接或自定义错误类型更合适:
- 并行执行多个任务(如 goroutine),部分失败需保留全部错误信息
- 一个操作涉及多个子步骤(如校验、写库、发消息),任一环节出错都应记录
- 需要向上层透传“一组错误”,同时保持每个错误的原始类型和上下文(比如仍能用
errors.Is或errors.As检查)
基本用法:合并多个错误
直接传入任意数量的 error 值,返回一个组合错误:
示例:
立即学习“go语言免费学习笔记(深入)”;
err1 := fmt.Errorf("failed to open file: %w", os.ErrPermission)
err2 := fmt.Errorf("failed to parse config: %w", io.ErrUnexpectedEOF)
err3 := errors.New("timeout waiting for service")
combined := errors.Join(err1, err2, err3)
fmt.Println(combined) // 输出类似:failed to open file: permission denied; failed to parse config: unexpected EOF; timeout waiting for service
注意:nil 值会被自动忽略,不参与合并。
检查与展开组合错误
errors.Join 返回的错误实现了 interface{ Unwrap() []error },因此支持标准错误分析:
-
errors.Is(combined, someErr):只要任一子错误匹配,就返回true -
errors.As(combined, &target):尝试将任一子错误赋值给target - 手动遍历:
for _, e := range errors.Unwrap(combined) { ... }(仅当combined是Join结果时有效)
这使得上层代码无需关心错误是否被合并,依然可用惯用方式做错误分类或重试判断。
结合 defer 和批量操作的实际场景
例如关闭多个资源时,避免因前一个 Close() 失败而掩盖后续错误:
func closeAll(closers ...io.Closer) error {
var errs []error
for _, c := range closers {
if err := c.Close(); err != nil {
errs = append(errs, err)
}
}
if len(errs) == 0 {
return nil
}
return errors.Join(errs...)
}
调用方拿到这个 error 后,仍可准确判断是否含 os.ErrClosed 或网络超时等具体类型,便于日志分级或告警策略。










