Pacote Context do Go
A maioria dos desenvolvedores Go utiliza context.Context sem entendê-lo. Você o vê em handlers HTTP, chamadas de banco de dados e métodos de SDK. Muitos iniciantes passam context.Background() em todos os lugares.
Esse erro causa problemas. Uma função Lambda pode ficar travada além do seu timeout. Uma consulta ao banco de dados pode continuar rodando após um usuário se desconectar.
O Context permite enviar sinais de cancelamento e prazos (deadlines) através do seu código. Ele ajuda você a responder a três perguntas:
• Esta operação deve continuar rodando? • Quando esta operação deve terminar? • Quais dados da requisição fluem com esta chamada?
A interface Context possui quatro métodos:
- Deadline(): Retorna quando o contexto será cancelado.
- Done(): Retorna um canal que é fechado quando o contexto é cancelado. Use isso em instruções select para interromper o trabalho.
- Err(): Retorna o motivo pelo qual o contexto parou (DeadlineExceeded ou Canceled).
- Value(): Recupera dados de escopo de requisição, como um Trace ID.
O Context funciona como uma árvore. Você começa com um contexto pai e cria filhos.
Contextos Raiz:
- context.Background(): Use isto no início do seu programa.
- context.TODO(): Use isto como um marcador (placeholder) durante a refatoração.
Contextos Filhos:
- context.WithCancel(): Permite interromper o trabalho manualmente.
- context.WithTimeout(): Interrompe o trabalho após uma duração específica.
- context.WithDeadline(): Interrompe o trabalho em um horário específico.
- context.WithValue(): Passa metadados, como IDs de usuário.
Regra Crucial: Sempre chame a função de cancelamento. Use defer cancel() imediatamente após criar um contexto filho. Se você pular isso, criará vazamentos de memória (memory leaks).
Melhores Práticas:
- Passe o context como o primeiro argumento para as funções.
- Não armazene o context em structs.
- Use context.WithValue apenas para metadados, não para dependências como clientes de banco de dados.
- Verifique ctx.Err() dentro de loops longos para sair antecipadamente.
- Use tipos personalizados para chaves de contexto para evitar colisões.
Quando um contexto pai é cancelado, todos os seus filhos são cancelados automaticamente. Isso torna fácil interromper uma cadeia inteira de operações em todo o seu sistema.