Como ler mensagens de erro:qualquer erro em 30 segundos
Como ler mensagens de erro quando a tua app feita com IA avaria: abre a consola do browser, decifra a primeira linha e o ficheiro, e corrige em 30 segundos.
Como ler mensagens de erro: não estás bloqueado, só não consegues ver o erro. Sempre que a tua aplicação feita com IA avaria "misteriosamente", escreve na consola do browser uma explicação exata do que correu mal. Abre a consola com um atalho de teclado, lê a primeira linha e o nome do ficheiro, e consegues decifrar quase qualquer erro em 30 segundos — sem precisares de um curso de engenharia.
Esta é a competência com mais alavancagem para um fundador não técnico que constrói com IA. Não porque vás corrigir todos os erros sozinho, mas porque a diferença entre "está partido, ajuda" e colar o erro exato no Claude é a diferença entre uma hora de palpites e uma correção de 30 segundos.
Como abrir a consola do browser
A consola são os bastidores do teu site. Se a tua aplicação for uma peça de teatro, a consola é onde vês os técnicos de palco, as deixas e o momento exato em que alguma coisa cai. Para a abrir:
- Chrome: Cmd + Option + J no Mac, Ctrl + Shift + J no Windows — ou clica com o botão direito em qualquer sítio, escolhe Inspecionar e depois clica no separador Console
- Firefox: Cmd + Option + K no Mac, Ctrl + Shift + K no Windows
- Safari: ativa primeiro o menu Programação (Definições, Avançadas, "Mostrar menu Programação"), depois Cmd + Option + C
Há dois separadores que importam. Console mostra erros e registos — começa aqui sempre que alguma coisa não funciona. Network mostra todos os pedidos que a tua aplicação faz aos servidores — usa-o quando o login falha ou os dados não carregam: atualiza a página, procura linhas a vermelho, clica numa para ver os detalhes. E não, não estragas nada só por olhar. A consola é, por defeito, apenas de leitura.
Como ler mensagens de erro: a anatomia
As mensagens de erro parecem intimidantes porque são escritas para programadores que conhecem o jargão. Mas têm uma estrutura fixa, como um diagnóstico médico — termos técnicos, uma localização exata e informação suficiente para resolver o problema. Quatro partes, sempre pela mesma ordem:
- O tipo de erro. A categoria: um TypeError significa que estás a usar algo da forma errada, um ReferenceError significa que estás a usar algo que não existe, um SyntaxError significa que o código tem uma gralha, um NetworkError significa que a aplicação não consegue chegar a um servidor.
- A descrição. O problema específico numa linha — "Cannot read property of undefined" significa que o código tentou usar dados que ainda não estão lá.
- A localização. Um nome de ficheiro, um número de linha e uma posição de carácter. Esta é a parte mais útil: diz-te exatamente onde procurar.
- A pilha de chamadas. A cadeia de chamadas de funções que levou ao erro. Normalmente só te interessam as primeiras linhas que mencionam ficheiros que reconheces — o resto é código interno de bibliotecas que podes ignorar.
O método dos 30 segundos: lê a primeira linha para saber o que correu mal, encontra o primeiro nome de ficheiro que reconheces para saber onde, e ignora tudo o que mencione o interior de bibliotecas.
Vermelho, amarelo, cinzento: o que significam as cores
A consola atribui uma cor a tudo consoante a gravidade, o que te diz o que merece a tua atenção:
- Vermelho = erro. Algo partiu agora mesmo e a aplicação não consegue continuar. Para e corrige.
- Amarelo = aviso. Hoje funciona, mas pode partir mais tarde ou ter mau desempenho. Corrige quando puderes — os avisos não param a tua aplicação.
- Branco ou cinzento = informação. Registos normais. Algumas bibliotecas são simplesmente faladoras. Ignora-os.
Uma consola cheia de mensagens não é automaticamente má. Concentra-te nas vermelhas, toma nota das amarelas e ignora o resto.
O livroThe Solopreneur RevolutionLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem deixar o emprego.Quero o livro →Os seis erros que vais mesmo ver (decifrados)
Quando constróis um SaaS com ferramentas de IA como o Claude e o Supabase, o mesmo punhado de erros explica quase tudo. Eis a tradução em linguagem simples:
| O erro | Em linguagem simples | A primeira coisa a experimentar |
|---|---|---|
| Cannot read property of undefined | O código está a usar dados que ainda não carregaram | Acrescenta uma verificação de carregamento antes de os dados serem usados |
| 401 Unauthorized | Não tens sessão iniciada, ou a tua sessão expirou | Termina a sessão, volta a entrar, tenta de novo |
| 403 Forbidden | Tens sessão iniciada, mas não tens permissão | Verifica o teu papel e as políticas de segurança da base de dados |
| 404 Not Found | A página ou o endpoint não existe | Verifica a grafia do URL; confirma que a rota existe |
| Network request failed | A aplicação não consegue sequer falar com o servidor | Confirma que o servidor de desenvolvimento está a correr e que as definições de URL estão certas |
| Row violates security policy | A camada de segurança da base de dados está a bloquear a operação | Verifica se estás autenticado e se a política permite esta ação |
Os códigos de estado seguem uma regra: tudo o que está nos 200 significa sucesso, os 400 significam que fizeste algo mal (dados errados, sem sessão iniciada, sem permissão, endereço errado) e os 500 significam que o próprio servidor avariou. Essa regra decifra todo o separador Network.
O que colar quando pedes ajuda à IA
É aqui que ler erros compensa. Quando entregas um erro ao Claude, a qualidade da resposta é decidida pelo que colas. Três coisas, sempre:
- A mensagem de erro completa — incluindo o nome do ficheiro e o número da linha, copiada diretamente da consola (botão direito na mensagem, Copiar)
- O código à volta do erro — cerca de cinco linhas antes e depois da linha para onde o erro aponta
- O que estavas a fazer — uma frase: "Estava a tentar carregar a página de perfil depois de iniciar sessão"
Com essas três coisas, a IA corrige a maioria dos erros à primeira. Sem elas, adivinha — e uma IA a adivinhar é o caminho para a confusão descrita em os sinais de que a IA está errada com toda a confiança. Se o mesmo erro continua a voltar, ou se estás bloqueado num cenário e não num erro isolado, o artigo seguinte percorre os dez problemas mais comuns ao construir com IA e as suas soluções.
Os erros não são o inimigo. São a aplicação a dizer-te exatamente do que precisa. Os fundadores que lançam não são os que nunca veem texto a vermelho — são os que deixaram de ter medo dele.
12 semanasA tua carreira corporativa nunca foi o planoCandidata-te ao Solopreneur Accelerator.Candidatar-me →Perguntas frequentes
Preciso de perceber código para ler mensagens de erro?
Não. Precisas de reconhecer as quatro partes — tipo, descrição, localização, pilha de chamadas — e de as copiar com rigor. O tipo de erro e a descrição ficam perto de linguagem corrente depois de veres os mais comuns, e a localização é só um nome de ficheiro e um número de linha. A IA faz o resto.
Posso estragar a minha aplicação ao usar a consola do browser?
Não. As ferramentas de programador são, por defeito, apenas de leitura — estás a espreitar os bastidores, não a mudar o cenário. Podes abrir a consola, percorrer os separadores e copiar mensagens sem qualquer risco para a tua aplicação ou para os teus dados.
Que erros devo corrigir primeiro?
Os erros a vermelho que bloqueiam os fluxos principais: erros de rede, erros de autenticação, erros de base de dados e tudo o que produza um ecrã em branco. Os avisos a amarelo podem esperar. Os registos informativos a cinzento não exigem ação nenhuma — são só a aplicação a narrar o seu dia.
E se a consola não mostrar erros mas a aplicação continuar a portar-se mal?
Verifica o separador Network à procura de linhas a vermelho — um pedido falhado nem sempre gera um erro visível na consola. Se a rede também estiver limpa, provavelmente os dados estão a ser filtrados em vez de falharem: conta errada, registos inativos ou uma flag de rascunho. Esse cenário e mais nove estão decifrados no guia dos problemas comuns ao construir com IA.
Quão preso estás, a sério?
Faz o Índice de Sufocamento Corporativo, a avaliação gratuita para saberes se estás pronto para ser um EUpreendedor.