Go函数不能直接返回多个error，只能通过errors.Join（Go 1.20+）或自定义MultiError类型将多个错误合并为一个error值，以支持错误链和匹配；互斥路径或需隐藏细节时不宜使用。
Go 里函数不能直接返回多个 error
Go 的函数签名只允许一个 error 类型返回值，这是语言设计决定的。你写不出 func foo() (int, error, error) 这样的签名——编译器会报错：syntax error: unexpected comma。所谓“多重错误”，本质是把多个错误信息打包进一个 error 值里，再统一返回。
用 errors.Join 合并多个错误（Go 1.20+）
这是最直接、标准的方案。它把多个 error 合成一个可展开的复合错误，支持 errors.Is 和 errors.As，也保留原始错误链。
-
errors.Join(nil, err1, nil, err2)会自动跳过nil - 合并后仍可用
fmt.Println(err)打印出所有错误消息，用换行分隔 - 如果其中某个错误实现了
Unwrap() []error（比如另一个Join结果），它会递归展开
err1 := fmt.Errorf("failed to open file")
err2 := fmt.Errorf("invalid JSON format")
combined := errors.Join(err1, err2)
// combined.Error() → "failed to open file\ninvalid JSON format"
手动构造自定义多错误类型（兼容旧版本或需控制行为）
当需要更精细的控制（比如按类别分类、添加上下文字段、避免重复打印），可以实现自己的 error 类型。关键点是实现 Error() 和 Unwrap() 方法。
- 不要只拼接字符串，否则丢失错误链；必须通过
Unwrap()返回子错误切片 - 若想支持
errors.Is匹配任意一个子错误，Unwrap()返回的切片不能为nil（哪怕为空） - 避免在
Error()中调用fmt.Sprintf拼接大量日志，会影响性能
type MultiError struct {
errs []error
}
func (m *MultiError) Error() string {
if len(m.errs) == 0 {
return "no errors"
}
var msgs []string
for _, e := range m.errs {
if e != nil {
msgs = append(msgs, e.Error())
}
}
return strings.Join(msgs, "; ")
}
func (m *MultiError) Unwrap() []error { return m.errs }
什么时候不该用多重错误？
不是所有场景都适合合并错误。容易被忽略的关键点：
立即学习“go语言免费学习笔记（深入）”；
- 如果多个错误来自互斥路径（比如 “A 失败” 或 “B 失败”，但不会同时发生），返回第一个非
nil错误更清晰 - HTTP handler 中返回
errors.Join后，客户端看到的是完整堆叠文本，可能泄露内部细节；应先用fmt.Errorf("internal server error: %w", err)包装并隐藏 - 日志记录时，直接传入
errors.Join结果，log/slog能自动展开；但若用老式log.Printf，需手动遍历errors.Unwrap
真正需要多重错误的典型场景其实很窄：批量操作（如同时写多个文件）、校验多个字段、聚合下游多个服务响应。多数单路径逻辑，一个错误就够了。
