Golang多错误返回技巧解析

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 }

什么时候不该用多重错误？

不是所有场景都适合合并错误。容易被忽略的关键点：

• 如果多个错误来自互斥路径（比如 “A 失败” 或 “B 失败”，但不会同时发生），返回第一个非 nil 错误更清晰
• HTTP handler 中返回 errors.Join 后，客户端看到的是完整堆叠文本，可能泄露内部细节；应先用 fmt.Errorf("internal server error: %w", err) 包装并隐藏
• 日志记录时，直接传入 errors.Join 结果，log/slog 能自动展开；但若用老式 log.Printf，需手动遍历 errors.Unwrap

真正需要多重错误的典型场景其实很窄：批量操作（如同时写多个文件）、校验多个字段、聚合下游多个服务响应。多数单路径逻辑，一个错误就够了。