Go中通过自定义MultiError类型聚合多个错误，结合fmt.Errorf的%w封装保留上下文，适用于并发或批量场景，确保所有错误被收集且可追溯，提升错误排查效率。
在Go语言中，函数返回多个错误值的情况并不常见，因为标准做法是一个函数只返回一个error。但实际开发中，有时会遇到需要处理多个子任务各自出错的场景，比如并发执行多个操作、批量处理数据等。这时就需要对多个错误进行聚合与封装，而不是简单地忽略或只返回其中一个。
错误聚合：将多个错误合并为一个
当多个操作可能同时失败时，直接返回第一个错误可能会丢失上下文信息。更好的方式是把所有发生的错误收集起来，统一返回。
可以通过自定义类型实现错误聚合：
示例：实现一个错误列表
type 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)
}
使用这个结构可以在批量操作中收集所有错误：
立即学习“go语言免费学习笔记（深入）”；
- 遍历每个操作，执行并记录错误
- 不因单个失败中断整体流程（除非必须）
- 最后判断
MultiError是否为空来决定是否出错
错误封装：保留原始错误的同时添加上下文
Go 1.13以后推荐使用%w格式化动词封装错误，这样可以保留调用链信息，便于后续用errors.Is和errors.As进行判断。
示例：封装错误并携带上下文
if err := doSomething(); err != nil {
return fmt.Errorf("failed to process item %s: %w", itemName, err)
}
这样做有以下几个好处：
- 外层能通过
errors.Cause或errors.Unwrap追溯根本原因 - 日志中可清晰看到完整调用路径
- 测试时可用
errors.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
}
这种方式确保了：
- 所有失败都被记录，不会遗漏
- 每个错误都包含具体任务编号等上下文
- 最终返回的是结构化的多错误对象
基本上就这些。关键在于根据业务需求选择是否中断流程，以及如何组织错误信息以便排查问题。聚合不是目的，提供清晰、可追溯的错误才是重点。
