Erro em produção: como corrigir bugs sem parar o negócio

Todo software tem falhas. O que diferencia uma operação madura é como ela reage quando um erro chega aos clientes. Este guia resume uma abordagem segura, útil tanto para quem tem equipe própria quanto para quem precisa contratar ajuda externa.

1. Conter o impacto primeiro

Antes de procurar a causa, reduza o dano:

• Voltar para a última versão estável, se o erro surgiu depois de uma atualização.
• Desligar a função problemática temporariamente, se for possível isolá-la.
• Comunicar clientes e equipe sobre o que está acontecendo e o que fazer enquanto isso.

Corrigir com pressa, direto em produção, é a forma mais comum de transformar um problema em dois.

2. Registrar o que se sabe

Anote: quando começou, quem é afetado, qual a mensagem de erro, o que mudou recentemente (atualização, configuração, fornecedor). Essas informações reduzem muito o tempo de diagnóstico.

3. Reproduzir em ambiente seguro

A correção confiável começa pela reprodução controlada do erro em um ambiente de testes. Se o erro não pode ser reproduzido, os registros (logs) e ferramentas de monitoramento passam a ser a principal fonte de evidência.

4. Encontrar a causa, não só o sintoma

Um sintoma (“o pagamento não foi confirmado”) pode ter várias causas: um webhook que falhou, uma chave expirada, uma mudança na API do provedor, um erro de concorrência. Tratar só o sintoma faz o problema voltar.

5. Corrigir com um teste junto

Toda correção deveria vir acompanhada de um teste automatizado que falha com o erro e passa com a correção. É isso que impede o mesmo bug de reaparecer meses depois.

6. Publicar com plano de reversão

• Publique em horário de menor uso, quando possível.
• Tenha um caminho rápido para voltar à versão anterior.
• Verifique em produção se o problema foi realmente resolvido.

7. Aprender com o incidente

Um registro curto e sem culpados — o que aconteceu, por que, como foi resolvido e o que muda para evitar a repetição — transforma o incidente em melhoria.

Quando chamar ajuda externa

• O desenvolvedor original não está mais disponível.
• O erro é intermitente e a equipe não consegue reproduzi-lo.
• O problema envolve integrações com terceiros (pagamentos, ERPs, APIs).
• Falta tempo para investigar sem parar outras entregas.

Ao contratar, conceda apenas os acessos necessários, preferencialmente com usuários próprios e permissões limitadas, que possam ser revogados ao final. Nunca envie senhas por formulários públicos ou mensagens abertas.

Prevenção

A maior parte das emergências pode ser evitada com o básico bem feito: monitoramento de erros, backups testados, atualização periódica de dependências e testes automatizados nas partes críticas.

Se o seu sistema está com problemas agora, descreva o que está acontecendo e marque o prazo como urgente.