Có một đoạn code Go mình từng viết, gọi 3 service nội bộ để dựng một trang dashboard. Ban đầu dùng sync.WaitGroup, chạy ngon. Tới ngày một service trả lỗi, mình mới phát hiện: lỗi bị nuốt mất, 2 goroutine còn lại cứ chạy tiếp cho hết timeout 30 giây. Cái này errgroup sinh ra để xử lý.
WaitGroup thiếu hai thứ: lỗi và tín hiệu dừng
WaitGroup chỉ biết đếm. Muốn lấy lỗi, bạn phải tự tạo channel hoặc biến chung có mutex. Muốn huỷ các goroutine còn lại khi một cái hỏng, bạn phải tự nối context vô từng cái. Làm tay thì dễ sót, và sót là rò goroutine (mình có kể ở bài goroutine leak trong Go).
Ảnh: nhiều đường ống chạy song song, một ống nứt làm các van còn lại tự đóng — giống cách errgroup huỷ cả nhóm khi một goroutine trả lỗi — ảnh minh hoạ do AI tạo (Grok Imagine)
golang.org/x/sync/errgroup gói hai việc đó lại:
g.Go(func() error)chạy một goroutine, lỗi đầu tiên khác nil được giữ lại.errgroup.WithContext(ctx)trả về context bị huỷ ngay khi có lỗi đầu tiên, hoặc khiWait()xong.g.Wait()chờ tất cả, trả về lỗi đầu tiên.
Ví dụ: gọi 3 service, một cái lỗi thì dừng hết
func loadDashboard(ctx context.Context, userID string) (*Dashboard, error) {
g, ctx := errgroup.WithContext(ctx)
var d Dashboard
g.Go(func() error {
var err error
d.Profile, err = fetchProfile(ctx, userID)
return err
})
g.Go(func() error {
var err error
d.Orders, err = fetchOrders(ctx, userID)
return err
})
g.Go(func() error {
var err error
d.Stats, err = fetchStats(ctx, userID)
return err
})
if err := g.Wait(); err != nil {
return nil, err
}
return &d, nil
}
Mỗi goroutine ghi vào một field khác nhau của d nên không cần mutex. Điểm mấu chốt: các hàm fetch* phải nhận ctx mới (cái do WithContext trả về, mình shadow luôn biến ctx). Nếu lỡ dùng ctx cũ thì huỷ gì cũng không ăn thua. Nếu bạn chưa chắc cách context lan truyền, đọc lại context trong Go.
SetLimit: đừng bắn 10.000 goroutine một lượt
Từ bản gần đây, errgroup có g.SetLimit(n). Khi đủ n goroutine đang chạy, g.Go sẽ chặn cho tới khi có chỗ trống. Nhờ vậy bạn có luôn một worker pool nhỏ gọn.
Ảnh: bàn tay chỉ phát một số token nhất định, các worker nhỏ phải xếp hàng chờ — chính là SetLimit giữ số goroutine chạy cùng lúc ở mức n — ảnh minh hoạ do AI tạo (Grok Imagine)
g, ctx := errgroup.WithContext(ctx)
g.SetLimit(8)
for _, url := range urls {
g.Go(func() error {
return download(ctx, url)
})
}
if err := g.Wait(); err != nil {
log.Printf("download failed: %v", err)
}
Từ Go 1.22, biến vòng lặp url đã là biến riêng cho mỗi lần lặp, nên không cần copy url := url như hồi trước nữa. Còn ở bản cũ hơn thì vẫn phải copy, không là mọi goroutine đọc cùng một giá trị.
Ba cái bẫy mình đã dính
- Chỉ lỗi đầu tiên được trả về. Các lỗi sau bị bỏ. Nếu cần gom hết, dùng
errors.Jointrong từng goroutine rồi tự thu thập, hoặc log lỗi ngay tại chỗ. - Huỷ là "xin", không phải "ép". Goroutine không kiểm tra
ctx.Done()thì vẫn chạy tới cuối. Hàm nào chặn lâu (HTTP, DB, sleep) phải nhận context. - Panic không được bắt. Một goroutine panic là cả process sập. Nếu code gọi thư viện lạ, bọc
recovervà đổi thành error.
Nếu bạn từng đau đầu với chia sẻ state giữa các task ở ngôn ngữ khác, bài Arc, Mutex hay channel trong Rust cho thấy cùng bài toán nhưng cách giải khác hẳn.
Khi nào dùng, khi nào không
Ảnh: nhiều sợi chỉ riêng lẻ được buộc lại bằng một nút duy nhất — tượng trưng cho việc errgroup gom kết quả và lỗi của cả nhóm về một chỗ ở Wait() — ảnh minh hoạ do AI tạo (Grok Imagine)
Dùng errgroup khi các việc cùng phục vụ một kết quả chung: "một cái hỏng thì kết quả vô nghĩa". Gọi nhiều API để dựng một response, tải nhiều file, quét nhiều shard.
Đừng dùng khi các việc độc lập, lỗi của cái này không nên làm chết cái kia (gửi 100 email chẳng hạn). Lúc đó dùng WaitGroup kèm thu lỗi riêng, hoặc errgroup mà mỗi goroutine luôn return nil và tự ghi lỗi.
Quy tắc mình rút ra: cứ thấy WaitGroup đi kèm một cái channel lỗi, hãy thử thay bằng errgroup. Code ngắn hơn một nửa, và ít chỗ để quên huỷ hơn. Bạn đang xử lý lỗi nhiều goroutine theo cách nào?
📋 Phụ lục thuật ngữ
| Thuật ngữ | Giải thích ngắn |
|---|---|
| errgroup | Package x/sync/errgroup: chạy nhóm goroutine, gom lỗi đầu tiên |
| WaitGroup | Bộ đếm chờ goroutine xong, không lo lỗi |
| context | Đối tượng mang tín hiệu huỷ/timeout đi qua các hàm |
| SetLimit | Giới hạn số goroutine chạy đồng thời trong group |
| Worker pool | Nhóm worker cố định xử lý hàng đợi việc |
