Lista de verificação de depuração:a ordem de 5 minutos

Uma lista de verificação de depuração: quando alguma coisa avaria, verifica as coisas exatamente por esta ordem: atualiza a página, lê a consola, confirma que tens sessão iniciada, confirma que a aplicação está mesmo a correr, confirma que guardaste as alterações. Essas cinco verificações levam cinco minutos e resolvem 90% dos problemas. A ordem é o método — a maioria dos fundadores depura a adivinhar ao acaso, e é por isso que continua bloqueada.

Depurar é uma competência, não magia. Eis a lista completa, da verificação rápida de cinco minutos à opção nuclear.

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

1. Atualiza a página. Limpa o estado temporário e volta a carregar os teus dados. Se uma atualização normal não ajudar, faz uma atualização forçada — mantém o Shift carregado enquanto atualizas — que também limpa os ficheiros em cache que o browser pode estar a servir desde a semana passada.
2. Abre a consola e procura vermelho. A consola de programador do browser é onde os erros se anunciam. Texto a vermelho é um erro, e a mensagem costuma indicar o ficheiro e a linha. Se parecer hieróglifos, como ler mensagens de erro decifra os padrões.
3. Tens sessão iniciada? A maioria das funcionalidades exige autenticação, e as sessões expiram sem avisar. Procura os teus dados de utilizador no cabeçalho; na dúvida, termina a sessão e volta a entrar. Uma parte espantosa das funcionalidades "avariadas" é apenas uma sessão expirada.
4. A aplicação está mesmo a correr? Se estás a trabalhar localmente, verifica o terminal — o teu servidor de desenvolvimento deve estar a imprimir registos. Se foi abaixo ou nunca foi iniciado, nada vai funcionar, e nenhuma quantidade de tempo a olhar para o código o vai resolver.
5. Guardaste o ficheiro? As alterações por guardar não correm. Procura o ponto ao lado do nome do ficheiro no teu editor. Sim, esta apanha toda a gente.

A maioria dos bugs é assim tão simples: sessão não iniciada, esqueceste-te de guardar, servidor parado, gralha, esqueceste-te de atualizar. Começa pelas coisas simples — não é indigno de ti, é estatística.

A verificação aprofundada de 15 minutos

Se a verificação rápida não encontrou o problema, desce uma camada — ainda por ordem, ainda uma coisa de cada vez:

• Limpa a cache do browser. Ficheiros antigos em cache podem entrar em conflito com código novo. Uma atualização forçada normalmente resolve.
• Abre o separador Network. Nas mesmas ferramentas de programador, o separador Network mostra todos os pedidos que a tua aplicação faz. Atualiza a página, procura linhas a vermelho — pedidos falhados — e lê os respetivos códigos de estado (tabela abaixo).
• As alterações à base de dados foram mesmo aplicadas? Se mudaste recentemente a estrutura da base de dados, confirma que a alteração correu — uma tabela ou coluna em falta parte tudo o que lhe toca. Verifica no painel da base de dados se a tabela que esperas está lá.
• Verifica o teu ficheiro de definições. As aplicações leem segredos e endereços de um ficheiro de ambiente. Valores em falta, uma chave errada ou espaços a mais partem tudo — e depois de o alterares, tens de reiniciar a aplicação para que ela dê pela mudança.
• Desconfia da tua alteração mais recente. Se funcionava há uma hora, o que quer que tenhas mudado desde então é o principal suspeito. Desfaz temporariamente ou comenta a alteração mais recente e vê se o problema desaparece.

O que te diz o separador Network

Essas quatro linhas transformam o separador mais assustador do browser numa enfermeira de triagem: dizem-te se o problema é a tua sessão, o teu endereço ou o teu código.

O livroThe Solopreneur RevolutionLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem deixar o emprego.Quero o livro →

A opção nuclear

Quando nada mais funciona, há a versão de programador do "desliga e volta a ligar": para a aplicação, apaga as dependências instaladas, reinstala-as de raiz, limpa a cache do browser e reinicia. Parece rudimentar, mas resolve de forma fiável instalações corrompidas, dependências desatualizadas e a enlouquecedora categoria do "funciona no computador do meu amigo, mas não no meu".

Usa-a em último lugar, não em primeiro — porque resolve as coisas sem te dizer o que estava errado, e da próxima vez vais ficar tão bloqueado como agora.

As três regras que fazem a lista funcionar

Muda uma coisa de cada vez. Se mudas cinco coisas e começa a funcionar, não sabes o que resolveu — o que significa que também não sabes o que partiu.

Testa depois de cada alteração. Não acumules correções. Faz uma alteração, verifica, avança.

Regista o que funcionou. Os mesmos bugs repetem-se. Um ficheiro de notas com "sintoma → solução" torna-se, num mês, a tua ferramenta de depuração mais rápida.

E quando a lista se esgota: escala de forma deliberada, não desesperada. Entrega o erro ao teu assistente de IA com os prompts de depuração com IA, ou escreve um relatório de bug a sério seguindo como pedir ajuda técnica. Nessa altura já consegues responder ao que estavas a fazer, ao que esperavas, ao que aconteceu e ao que já tentaste — que é exatamente o que a lista acabou de te fazer reunir.

12 semanasA tua carreira corporativa nunca foi o planoCandidata-te ao Solopreneur Accelerator.Candidatar-me →

Perguntas frequentes

O que devo verificar primeiro quando a minha aplicação avaria?

Atualiza a página e depois lê a consola. Esses dois passos levam menos de um minuto e resolvem sozinhos uma enorme parte dos problemas. Depois confirma que tens sessão iniciada, que a aplicação está a correr e que as tuas alterações estão guardadas. Só depois dessas cinco deves começar a ler código.

Porque é que importa depurar por uma ordem fixa?

Porque adivinhar ao acaso muda várias coisas ao mesmo tempo, e assim nunca aprendes o que estava realmente errado. Uma ordem fixa testa primeiro as causas mais prováveis e mais baratas de verificar e elimina-as uma a uma — o que, em média, é mais rápido e, de bónus, ensina-te os padrões de falha do teu sistema.

As minhas alterações não aparecem — o que se passa?

Por ordem de probabilidade: não guardaste o ficheiro, a aplicação não está a correr, o browser está a mostrar uma versão em cache (atualização forçada) ou estás a editar um ficheiro diferente daquele que a aplicação está a usar. As quatro são verificações de dois minutos e, juntas, cobrem quase todos os casos.

Quando devo parar de depurar e pedir ajuda?

Depois da verificação rápida e da verificação aprofundada — cerca de 20 minutos de trabalho sistemático. Nessa altura já consegues dizer o que estavas a fazer, o que esperavas, o que aconteceu, o erro exato e o que já tentaste. É tudo o que um bom pedido de ajuda precisa, quer estejas a pedir a uma IA, quer a um humano.