Go中通过自定义MultiError类型聚合多个错误，结合fmt.Errorf的%w封装保留上下文，适用于并发或批量场景，确保所有错误被收集且可追溯，提升错误排查效率。
在Go语言中，函数返回多个错误值的情况并不常见，因为标准做法是一个函数只返回一个
。但实际开发中，有时会遇到需要处理多个子任务各自出错的场景，比如并发执行多个操作、批量处理数据等。这时就需要对多个错误进行聚合与封装，而不是简单地忽略或只返回其中一个。
错误聚合：将多个错误合并为一个
当多个操作可能同时失败时，直接返回第一个错误可能会丢失上下文信息。更好的方式是把所有发生的错误收集起来，统一返回。
可以通过自定义类型实现错误聚合：
示例：实现一个错误列表
使用这个结构可以在批量操作中收集所有错误：
立即学习
“
go语言免费学习笔记（深入）
”；
遍历每个操作，执行并记录错误
不因单个失败中断整体流程（除非必须）
最后判断
是否为空来决定是否出错
错误封装：保留原始错误的同时添加上下文
Go 1.13以后推荐使用
格式化动词封装错误，这样可以保留调用链信息，便于后续用
和
进行判断。
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
示例：封装错误并携带上下文
这样做有以下几个好处：
外层能通过
或
追溯根本原因
日志中可清晰看到完整调用路径
测试时可用
精确匹配特定错误
结合聚合与封装处理复杂场景
在并发或批量处理中，既需要聚合多个独立错误，又希望每个错误都带有上下文。可以将两者结合使用。
示例：并发请求中的错误处理
这种方式确保了：
所有失败都被记录，不会遗漏
每个错误都包含具体任务编号等上下文
最终返回的是结构化的多错误对象
基本上就这些。关键在于根据业务需求选择是否中断流程，以及如何组织错误信息以便排查问题。聚合不是目的，提供清晰、可追溯的错误才是重点。
errortype MultiError []error
func (m MultiError) Error() string {
var msgs []string
for _, err := range m {
if err != nil {
msgs = append(msgs, err.Error())
}
}
return strings.Join(msgs, "; ")
}
func (m MultiError) Len() int {
return len(m)
}
MultiError%werrors.Iserrors.Asif err := doSomething(); err != nil {
return fmt.Errorf("failed to process item %s: %w", itemName, err)
}
errors.Causeerrors.Unwraperrors.Is(err, target)var (
mu sync.Mutex
errs MultiError
)
var wg sync.WaitGroup
for i := 0; i < len(tasks); i++ {
wg.Add(1)
go func(idx int) {
defer wg.Done()
if err := processTask(tasks[idx]); err != nil {
mu.Lock()
errs = append(errs, fmt.Errorf("task %d failed: %w", idx, err))
mu.Unlock()
}
}(i)
}
wg.Wait()
if len(errs) > 0 {
return errs
}