![Imagem de capa de [Vibe Coder #5] Leia erros e escape do loop da IA](/assets/images/posts/7130fab4-6bf4-482f-baa3-e0f1e30625a6/error-message-confession-1.jpg)
Quando mensagens de erro vermelhas cobrem a tela, o coração dispara. O inglês é denso, cheio de palavras desconhecidas e parece não dizer o que deu errado. Por isso, muitos vibe coders fecham a mensagem sem ler e dizem à IA: “Não funciona, conserte.” E a IA começa a mexer no lugar errado.
Aqui está a armadilha. Uma mensagem de erro é, na verdade, a confissão deixada pelo culpado. O que aconteceu e onde aconteceu já está escrito ali. Quando você aprende a ler, metade do problema está resolvida; ao passar isso para a IA sem alterações, a outra metade anda mais rápido. Este episódio mostra como ler mensagens de erro, como transmiti-las corretamente à IA e como escapar quando a IA não consegue corrigir o mesmo bug e continua dando voltas.
A estrutura de uma mensagem de erro: basta encontrar três coisas
Todo erro tem a mesma estrutura. Você só precisa encontrar três partes.
- O que aconteceu (nome e descrição do erro): normalmente é a primeira linha. Algo como
TypeError: Cannot read properties of undefined. Literalmente, significa “tentou tirar algo do nada”. É como tentar abrir uma encomenda que nunca chegou. - Onde aconteceu (arquivo e número da linha): se aparecer algo como
app/page.tsx:42, significa que ocorreu na linha 42 do arquivoapp/page.tsx. Essa é a cena do crime. - Por qual caminho aconteceu (stack trace): a lista que aparece abaixo é o caminho de chamadas até o incidente. Não precisa se assustar; basta saber que as primeiras linhas são os registros mais próximos da cena do crime.
Você não precisa entender tudo. Se captar apenas “o que aconteceu + onde”, já está dez vezes à frente de quem não lê erros.
Erros moram em dois lugares
A distinção da Parte 1 volta aqui. Os erros aparecem em dois lugares, e onde procurar depende do sintoma.
- Console do navegador (o grito do frontend): quando a tela fica branca, os botões não respondem ou parte da interface quebra. Pressione F12 no navegador (ou clique com o botão direito → Inspecionar) e abra a aba Console.
- Logs do servidor (o grito do backend): quando salvar, fazer login, pagar ou chamar a IA falha. Durante o desenvolvimento, eles aparecem no terminal onde o programa está rodando; após o deploy, aparecem no menu Logs do dashboard do serviço de deploy visto na Parte 4.
A tela pode mostrar apenas “Ocorreu um problema”, enquanto os logs do servidor contêm a causa real. Não olhe só para a tela e conclua “não há mensagem de erro”; crie o hábito de abrir os dois lugares.
Como transmitir erros à IA: envie tudo, com contexto
Depois de encontrar o erro, transmita-o à IA assim.
- Copie a mensagem inteira. As linhas seguintes costumam conter pistas, então não envie apenas a primeira. Copiar o texto é melhor do que enviar uma captura de tela.
- Inclua o contexto. Diga o que você estava fazendo quando aconteceu, como “depois que cliquei no botão de cadastro”, e o que esperava, como “deveria ter ido para a página de boas-vindas”.
- Diga onde encontrou o erro. Foi “no console do navegador” ou “nos logs do servidor”? Essa informação reduz pela metade a área que a IA precisa investigar.
A diferença entre uma pergunta ruim e uma boa é enorme. “Não consigo salvar, conserte” manda a IA procurar sem mapa. “Quando clico em Salvar, a tela permanece igual, mas este erro aparece nos logs do servidor: (cole o erro completo). O esperado era aparecer uma nova publicação na lista” entrega à IA a cena do crime e a confissão.
Quando a IA fica dando voltas: 4 formas de escapar
Se a IA já falhou três ou quatro vezes ao tentar corrigir o mesmo bug, daí em diante é mais rápido mudar o jogo do que aumentar o número de tentativas.
1. Abra uma nova conversa. Em uma conversa cheia de tentativas fracassadas, a IA continua presa às hipóteses erradas que criou. Abra uma nova conversa e transmita claramente apenas o sintoma e o erro atuais; muitas vezes, ela resolve logo na primeira tentativa.
2. Faça rollback e tente de novo em passos menores. O save point da Parte 3 brilha aqui. Se alterações sucessivas transformaram o código em uma colcha de retalhos, volte ao último commit e peça novamente a alteração que falhou, uma unidade menor por vez.
3. Peça uma investigação primeiro. Em vez de “conserte”, diga: “Não conserte ainda. Encontre três causas possíveis para este erro e diga como verificar cada uma.” Quando você manda consertar, a IA se apressa; quando manda investigar, ela surpreendentemente investiga com calma. Depois de restringir a causa, peça a correção: a precisão aumenta bastante.
4. Pesquise o erro original. Cole a primeira linha da mensagem de erro diretamente no campo de busca. É bem provável que alguém no mundo já tenha enfrentado e resolvido o problema. Também é poderosa a combinação de fornecer à IA um link dos resultados e pedir: “Verifique se essa solução se aplica à minha situação”.
Resumo
- Mensagens de erro são confissões. Encontre apenas “o que aconteceu (primeira linha) + onde (arquivo:número da linha)” e metade do problema está resolvida.
- Os erros moram em dois lugares: no console do navegador (problemas na tela) e nos logs do servidor (problemas ao salvar, fazer login e pagar). Abra os dois.
- Passe à IA três coisas juntas: o erro completo, o que você estava fazendo quando aconteceu e onde o encontrou.
- Quando a IA fica dando voltas, não aumente o número de tentativas: mude o jogo. Nova conversa, rollback e passos menores, investigar primeiro, pesquisar o erro original.
No próximo episódio, vamos tratar de um problema clássico que parece um mistério: “Funcionava até ontem, mas hoje não funciona.” Por que ele para de funcionar de repente se você não mexeu no código? Vamos analisar os possíveis culpados em ordem.