Checklist de depuração para fundadores:a ordem de 5 minutos

Um checklist de depuração: quando algo quebrar, cheque as coisas nesta ordem exata: recarregue a página, leia o console, confirme que você está logado, confirme que o app está realmente rodando, confirme que você salvou as alterações. Essas cinco checagens levam cinco minutos e resolvem 90% dos problemas. A ordem é o método — a maioria dos fundadores depura chutando ao acaso, e é por isso que continua travada.

Depurar é uma habilidade, não mágica. Aqui está o checklist completo, da checagem rápida de cinco minutos até a opção nuclear.

Checklist de depuração, passo 1: a checagem rápida de 5 minutos (90% dos problemas)

1. Recarregue a página. Isso limpa o estado temporário e recarrega seus dados. Se um recarregamento simples não ajudar, faça um recarregamento forçado — segure Shift enquanto recarrega —, que também descarta os arquivos em cache que o navegador pode estar servindo desde a semana passada.
2. Abra o console e procure vermelho. O console de desenvolvedor do navegador é onde os erros se anunciam. Texto vermelho é erro, e a mensagem geralmente diz o arquivo e a linha. Se parecer hieróglifo, como ler mensagens de erro decifra os padrões.
3. Você está logado? A maioria das funcionalidades exige autenticação, e as sessões expiram em silêncio. Procure suas informações de usuário no cabeçalho; na dúvida, saia e entre de novo. Uma parcela impressionante das funcionalidades "quebradas" é só um login expirado.
4. O app está realmente rodando? Se você está trabalhando localmente, olhe o terminal — seu servidor de desenvolvimento deveria estar imprimindo logs. Se ele caiu ou nunca foi iniciado, nada vai funcionar, e nenhuma quantidade de olhar para o código vai resolver.
5. Você salvou o arquivo? Alterações não salvas não rodam. Procure o pontinho ao lado do nome do arquivo no seu editor. Sim, essa pega todo mundo.

A maioria dos bugs é simples assim: não estava logado, esqueceu de salvar, servidor não estava rodando, erro de digitação, esqueceu de recarregar. Comece pelo simples — não está abaixo de você, é estatística.

A checagem profunda de 15 minutos

Se a checagem rápida não encontrou, desça uma camada — ainda na ordem, ainda uma coisa de cada vez:

• Limpe o cache do navegador. Arquivos antigos em cache podem entrar em conflito com o código novo. Um recarregamento forçado geralmente resolve.
• Abra a aba Network (Rede). Nas mesmas ferramentas de desenvolvedor, a aba Network mostra cada requisição que seu app faz. Recarregue a página, procure linhas vermelhas — requisições que falharam — e leia os códigos de status (tabela abaixo).
• As mudanças no banco de dados foram realmente aplicadas? Se você mudou a estrutura do banco de dados recentemente, confirme que a mudança rodou — uma tabela ou coluna faltando quebra tudo o que encosta nela. Procure no painel do banco de dados a tabela que você espera encontrar.
• Cheque seu arquivo de configuração. Os apps leem segredos e endereços de um arquivo de ambiente. Valores faltando, uma chave errada ou espaços a mais quebram tudo — e, depois de alterá-lo, você precisa reiniciar o app para ele perceber.
• Desconfie da sua mudança mais recente. Se funcionava uma hora atrás, o que você mudou desde então é o principal suspeito. Desfaça ou comente temporariamente a mudança mais nova e veja se o problema desaparece.

O que a aba Network está te dizendo

Essas quatro linhas transformam a aba mais assustadora do navegador numa enfermeira de triagem: elas te dizem se o problema é a sua sessão, o seu endereço ou o seu código.

O livroA Revolução do EUpreendedorLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem largar o emprego.Quero o livro →

A opção nuclear

Quando nada mais funciona, existe a versão de desenvolvedor do "desliga e liga de novo": pare o app, apague as dependências instaladas, reinstale-as do zero, limpe o cache do navegador e reinicie. Parece grosseiro, mas resolve com confiabilidade instalações corrompidas, dependências desatualizadas e a categoria enlouquecedora do "funciona no computador do meu amigo, mas não no meu".

Use por último, não primeiro — porque ela conserta as coisas sem te dizer o que estava errado, e na próxima vez você vai estar tão travado quanto agora.

As três regras que fazem o checklist funcionar

Mude uma coisa de cada vez. Se você muda cinco coisas e passa a funcionar, não sabe o que consertou — o que significa que também não sabe o que quebrou.

Teste depois de cada mudança. Não empilhe correções. Faça uma mudança, cheque, siga em frente.

Documente o que funcionou. Os mesmos bugs voltam. Um arquivo de anotações de "sintoma → correção" vira sua ferramenta de depuração mais rápida em um mês.

E quando o checklist se esgotar: escale de forma deliberada, não desesperada. Entregue o erro ao seu assistente de IA usando os prompts de depuração com IA, ou escreva um bom relatório de bug seguindo como pedir ajuda técnica. A essa altura você consegue responder o que estava fazendo, o que esperava, o que aconteceu e o que já tentou — que é exatamente o que o checklist acabou de te fazer reunir.

12 semanasA sua carreira corporativa nunca foi o planoCandidate-se à Aceleradora de EUpreendedores.Candidatar-se →

Perguntas frequentes

O que devo checar primeiro quando meu app quebra?

Recarregue a página e depois leia o console. Esses dois passos levam menos de um minuto e, sozinhos, resolvem uma parcela enorme dos problemas. Depois confirme que você está logado, que o app está rodando e que suas alterações estão salvas. Só depois desses cinco você deve começar a ler código.

Por que depurar numa ordem fixa importa?

Porque chutar ao acaso muda várias coisas ao mesmo tempo, e você nunca descobre o que realmente estava errado. Uma ordem fixa testa primeiro as causas mais prováveis e mais baratas de checar e as elimina uma a uma — o que, em média, é mais rápido e ainda te ensina os padrões de falha do seu sistema.

Minhas alterações não aparecem — o que está errado?

Por ordem de probabilidade: você não salvou o arquivo, o app não está rodando, o navegador está mostrando uma versão em cache (recarregamento forçado) ou você está editando um arquivo diferente daquele que o app está usando. As quatro são checagens de dois minutos e, juntas, cobrem quase todos os casos.

Quando devo parar de depurar e pedir ajuda?

Depois da checagem rápida e da checagem profunda — uns 20 minutos de trabalho sistemático. A essa altura você consegue dizer o que estava fazendo, o que esperava, o que aconteceu, o erro exato e o que já tentou. É tudo de que um bom pedido de ajuda precisa, seja para uma IA ou para uma pessoa.