Go errors.Join 组合 nil 错误时返回值怎么判断

先给结论：errors.Join 会忽略传入参数中的 nil。当所有参数都是 nil 时，返回值才是 nil；只要至少有一个非 nil 错误，返回值就是一个非 nil 的聚合错误。因此判断结果只需要写 if err != nil，不要根据错误字符串或传入参数数量猜测。

这个规则适合批量校验、批量关闭资源和并行任务收集结果。下面按接口语义、判断方式和具体错误识别拆开说明。

一、errors.Join 的返回值取决于有效错误

errors.Join 从 Go 1.20 开始提供。它会过滤 nil，再把剩余错误组合起来；组合结果实现了 Unwrap() []error，所以后续仍能用 errors.Is 或 errors.As 检查内部错误。

二、直接用 err != nil 判断组合结果

批量函数可以先收集每项返回的错误，再统一 Join。关键是把 Join 的返回值作为最终状态，而不是把切片长度当成失败数量。

package main

import (
    "errors"
    "fmt"
)

func validate(name string) error {
    if name == "" {
        return errors.New("名称不能为空")
    }
    return nil
}

func validateAll(names []string) error {
    var errs []error
    for _, name := range names {
        // 只收集真实错误，成功项返回的 nil 不改变最终状态。
        errs = append(errs, validate(name))
    }
    // Join 会丢弃 errs 中的 nil；全是 nil 时这里仍返回 nil。
    return errors.Join(errs...)
}

func main() {
    err := validateAll([]string{"Go", "", "errors.Join"})
    if err != nil {
        fmt.Println("校验失败：", err)
        return
    }
    fmt.Println("校验通过")
}

如果输入是 []string{"Go", "errors.Join"}，validate 只会产生两个 nil，Join 的结果仍为 nil；如果有一个空名称，就会得到非 nil 错误。

三、不要把 nil 参数数量当成错误数量

一个常见误区是看到传入了多个参数，就认为 Join 一定返回非 nil。实际上，Join 只关心有效错误。例如 errors.Join(nil, nil, nil) 与直接返回 nil 的语义相同。

因此批量操作中可以放心让每个子任务返回 nil。调用方不需要在每个位置额外做过滤，但如果还要统计失败项，应该单独维护计数或保存失败项，而不是从聚合错误的文本中拆分。

四、聚合后用 errors.Is 判断具体错误

Join 不会把内部错误变成不可识别的字符串。只要使用稳定的哨兵错误，调用方就能判断聚合结果里是否包含某类失败。

var ErrRetryable = errors.New("可重试失败")

func checkResult(err error) {
    if err == nil {
        fmt.Println("没有错误")
        return
    }
    // Is 会遍历 Join 形成的多错误树，不要直接比较 err == ErrRetryable。
    if errors.Is(err, ErrRetryable) {
        fmt.Println("至少有一项可以重试")
        return
    }
    fmt.Println("存在不可重试错误：", err)
}

这里先判空，再判具体类型或哨兵错误。直接比较聚合后的 err 通常不会命中某个内部错误，errors.Is 才是面向包装和聚合错误的判断方式。

五、写批量校验时的落地选择

如果调用方只需要知道“是否有失败”，返回 errors.Join(errs...) 就足够；如果还要展示每条失败记录，应同时保存记录标识和错误值。不要依赖多行 Error() 文本作为机器接口，因为文本适合日志，不适合协议判断。

可以按下面的规则快速检查：

• 所有子任务成功：Join 返回 nil，调用方进入成功分支。
• 至少一个子任务失败：Join 返回非 nil，调用方进入失败分支。
• 要识别某类失败：用 errors.Is 或 errors.As。
• 要统计失败数量：单独记录失败项，不解析 Error 字符串。

常见问题

errors.Join(nil, err) 会返回 err 本身吗？不会把 nil 放进结果，但返回的是一个聚合错误；调用方应只依赖非 nil 和 errors.Is 等语义，不依赖具体动态类型。

errors.Join() 没有参数时是什么？它等价于没有有效错误，返回 nil。

为什么不建议用 strings.Contains(err.Error(), "可重试")？错误文本可能变化，也可能包含同一句话但语义不同。用哨兵错误配合 errors.Is 更稳定。

errors.Unwrap 能拆开 errors.Join 吗？标准库的 errors.Unwrap 只处理 Unwrap() error，不处理 Join 提供的 Unwrap() []error；需要判断内部错误时直接使用 errors.Is 或 errors.As。

参考：Go errors.Join 文档。