Padrões de Concorrência em Go

Padrões de produção para concorrência em Go, incluindo goroutines, canais, primitivas de sincronização e gerenciamento de contexto.

Quando Usar Esta Habilidade

• Construir aplicações Go concorrentes
• Implementar pools de workers e pipelines
• Gerenciar ciclos de vida de goroutines
• Usar canais para comunicação
• Depurar condições de corrida (race conditions)
• Implementar desligamento gracioso (graceful shutdown)

Conceitos Principais

1. Primitivas de Concorrência em Go

2. Mantra de Concorrência em Go

Don't communicate by sharing memory;
share memory by communicating.

Início Rápido

package main

import (
    "context"
    "fmt"
    "sync"
    "time"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    results := make(chan string, 10)
    var wg sync.WaitGroup

    // Spawn workers
    for i := 0; i < 3; i++ {
        wg.Add(1)
        go worker(ctx, i, results, &wg)
    }

    // Close results when done
    go func() {
        wg.Wait()
        close(results)
    }()

    // Collect results
    for result := range results {
        fmt.Println(result)
    }
}

func worker(ctx context.Context, id int, results chan<- string, wg *sync.WaitGroup) {
    defer wg.Done()

    select {
    case <-ctx.Done():
        return
    case results <- fmt.Sprintf("Worker %d done", id):
    }
}

Padrões detalhados e exemplos práticos

A documentação detalhada dos padrões está em references/details.md. Leia este arquivo quando o nível de navegação acima for insuficiente.

Melhores Práticas

O Que Fazer (Do's)

• Use context - Para cancelamento e prazos (deadlines)
• Feche canais - Apenas do lado do remetente (sender)
• Use errgroup - Para operações concorrentes com erros
• Bufferize canais - Quando você souber a contagem
• Prefira canais - Em vez de mutexes, quando possível

O Que Não Fazer (Don'ts)

• Não vaze goroutines - Sempre tenha um caminho de saída
• Não feche do receptor - Causa pânico (panic)
• Não use memória compartilhada - A menos que seja necessário
• Não ignore o cancelamento do contexto - Verifique ctx.Done()
• Não use time.Sleep para sincronização - Use primitivas adequadas