如何在Golang中处理函数返回多错误_使用errors.Join或自定义结构

在Golang的实际开发中，很多函数执行过程中可能会同时出现多个不符合预期的情况，比如批量处理数据时部分数据校验失败、多个外部接口调用同时出错等。如果仅返回单个错误，会丢失大量关键信息，不利于后续的问题定位和修复。此时就需要采用合适的多错误返回处理方式，目前主流的方案有两种，分别是使用标准库的errors.Join方法和自定义错误结构。

使用errors.Join处理多错误

Go 1.20版本之后，标准库errors包新增了Join函数，专门用于将多个错误合并为一个错误返回，合并后的错误可以通过errors.Is、errors.As等方法正常判断，使用起来非常便捷。

基本用法

errors.Join的参数是可变数量的error类型，返回合并后的单个错误，所有传入的错误会被按顺序拼接，用换行符分隔。

package main

import (
    "errors"
    "fmt"
)

func batchCheck(nums []int) error {
    var errs []error
    for _, num := range nums {
        if num < 0 {
            errs = append(errs, fmt.Errorf("数字 %d 小于0", num))
        }
        if num%2 != 0 {
            errs = append(errs, fmt.Errorf("数字 %d 是奇数", num))
        }
    }
    if len(errs) > 0 {
        return errors.Join(errs...)
    }
    return nil
}

func main() {
    err := batchCheck([]int{1, -2, 3})
    if err != nil {
        fmt.Println("批量检查出错：")
        fmt.Println(err)
        // 可以单独判断合并后的错误是否包含某个特定错误
        targetErr := fmt.Errorf("数字 -2 小于0")
        if errors.Is(err, targetErr) {
            fmt.Println("存在小于0的数字")
        }
    }
}

适用场景

errors.Join适合错误之间没有强关联、不需要额外附加错误上下文信息的场景，比如批量操作的错误汇总、多个独立校验步骤的错误收集，它的优势是无需额外定义结构，直接使用标准库能力即可，代码简洁。

自定义错误结构处理多错误

如果需要对多个错误进行分类、附加更多上下文信息，或者需要自定义错误的展示格式，自定义错误结构是更灵活的选择。自定义错误结构只需要实现error接口的Error()方法即可。

实现方式

我们可以定义一个包含错误列表、错误类型等字段的结构，然后实现Error()方法返回自定义的错误描述。

package main

import (
    "fmt"
    "strings"
)

// 定义错误类型常量
type ErrType string

const (
    ErrTypeValidate ErrType = "校验错误"
    ErrTypeNet      ErrType = "网络错误"
)

// 自定义多错误结构
type MultiError struct {
    Errs    []error
    ErrType ErrType
}

// 实现error接口的Error方法
func (m *MultiError) Error() string {
    errMsgs := make([]string, 0, len(m.Errs))
    for _, err := range m.Errs {
        errMsgs = append(errMsgs, err.Error())
    }
    return fmt.Sprintf("[%s] 发生以下错误：%s", m.ErrType, strings.Join(errMsgs, "; "))
}

// 添加一个错误到多错误结构
func (m *MultiError) Add(err error) {
    if err != nil {
        m.Errs = append(m.Errs, err)
    }
}

// 判断是否存在错误
func (m *MultiError) HasError() bool {
    return len(m.Errs) > 0
}

func processTasks(tasks []string) error {
    multiErr := &MultiError{
        ErrType: ErrTypeNet,
    }
    for _, task := range tasks {
        // 模拟部分任务网络出错
        if task == "task2" {
            multiErr.Add(fmt.Errorf("任务 %s 调用接口超时", task))
        }
        if task == "task3" {
            multiErr.Add(fmt.Errorf("任务 %s 接口返回状态码500", task))
        }
    }
    if multiErr.HasError() {
        return multiErr
    }
    return nil
}

func main() {
    err := processTasks([]string{"task1", "task2", "task3"})
    if err != nil {
        fmt.Println(err)
        // 可以类型断言获取自定义结构的更多信息
        if me, ok := err.(*MultiError); ok {
            fmt.Printf("错误类型：%s，错误数量：%dn", me.ErrType, len(me.Errs))
        }
    }
}

适用场景

自定义错误结构适合错误需要分类、需要附加额外元数据的场景，比如不同模块的错误需要区分来源、需要记录错误发生的时间戳等。它的灵活性更高，但是需要额外定义结构，代码量相对更多。

两种方案的选择建议

如果项目使用的Go版本在1.20及以上，且错误不需要额外分类和元数据，优先选择errors.Join，减少自定义代码的维护成本；如果需要错误分类、自定义错误格式或者需要兼容更低版本的Go，选择自定义错误结构更合适。两种方案也可以结合使用，比如在自定义错误结构的Error()方法内部使用errors.Join合并内部的错误列表，兼顾灵活性和标准库能力。

Golangerrors.Join自定义错误结构多错误返回错误处理修改时间：2026-07-09 20:18:33