如何在Golang中处理并发场景下的错误_Golang goroutine错误收集方式_技术教程

g
oroutine 错误无法自动传播到主 goroutine，需通过 channel+WaitGroup 或 errgroup.Group 显式传递；recover 不跨协程生效，panic 不能替代 error 返回；错误处理核心在于明确失败策略而非仅技术选型。

goroutine 中的错误无法自动传播到主 goroutine

Go 的 goroutine 是独立执行的，一旦启动就和发起它的函数解耦。这意味着在子 goroutine 里调用 return 或发生 panic，不会中断主流程，更不会把错误“带回来”。常见表现是：主程序早早退出，而子任务里的 fmt.Println("failed:", err) 根本没来得及打印。

别指望用普通变量（如 err error）跨 goroutine 赋值 —— 竞态风险高，且无法同步完成状态
不要在 goroutine 内部直接 log.Fatal 或 os.Exit，这会杀掉整个进程，不是错误处理而是粗暴终止
如果多个 goroutine 都可能出错，需明确“只要一个错就失败”还是“等全部完成再汇总”

用 `sync.WaitGroup` + `chan error` 收集所有错误

这是最常用、最可控的方式：主 goroutine 启动工作协程，每个协程把错误发到同一个 chan error，主 goroutine 用 WaitGroup 等待全部结束，再统一读取错误通道。注意通道必须带缓冲，或配合 close 使用，否则可能阻塞。

var wg sync.WaitGroup
errCh := make(chan error, 5) // 缓冲大小 ≥ 可能出错的 goroutine 数量
for i := 0; i < 5; i++ {
wg.Add(1)
go func(id int) {
defer wg.Done()
if id == 2 {
errCh <- fmt.Errorf("task %d failed", id)
return
}
// 模拟成功任务
time.Sleep(10 * time.Millisecond)
}(i)
}
go func() {
wg.Wait()
close(errCh) // 所有 goroutine 完成后关闭通道
}()
var errors []error
for err := range errCh {
errors = append(errors, err)
}
if len(errors) > 0 {
fmt.Printf("got %d errors: %v\n", len(errors), errors)
}

用 `errgroup.Group` 简化错误传播逻辑

golang.org/x/sync/errgroup 封装了上述模式，自动处理首次错误取消、等待、通道管理。它适合“任一错误即整体失败”的场景（如并行初始化多个服务），也支持忽略部分错误继续执行。

调用 eg.Go 启动任务，返回的第一个非 nil error 会立刻被 eg.Wait() 返回
若想收集全部错误，需自己维护切片并在每个 eg.Go 回调中追加，errgroup 不提供内置聚合
注意 WithContext 版本可配合超时或取消控制，避免某个 goroutine 卡死拖垮全局

import "golang.org/x/sync/errgroup"
ctx := context.Background()
eg, ctx := errgroup.WithContext(ctx)
for i := 0; i < 3; i++ {
i := i // 避免闭包引用同一变量
eg.Go(func() error {
if i == 1 {
return fmt.Errorf("failed on index %d", i)
}
time.Sleep(10 * time.Millisecond)
return nil
})
}
if err := eg.Wait(); err != nil {
fmt.Println("first error:", err) // 输出 failed on index 1
}