Como ler mensagens de erro:qualquer erro em 30 segundos

Como ler mensagens de erro: você não está travado, só não está vendo o erro. Toda vez que o seu app feito com IA quebra "misteriosamente", ele escreve uma explicação exata do que deu errado no console do navegador. Abra o console com um atalho de teclado, leia a primeira linha e o nome do arquivo, e você consegue decifrar quase qualquer erro em 30 segundos — sem diploma de engenharia.

Essa é a habilidade de maior alavancagem para um fundador não técnico que constrói com IA. Não porque você vai corrigir todo erro sozinho, mas porque a diferença entre "quebrou, socorro" e colar o erro exato no Claude é a diferença entre uma hora de chute e uma correção de 30 segundos.

Como abrir o console do navegador

O console é o bastidor do seu site. Se o seu app é uma peça de teatro, o console é onde você vê os contrarregras, as deixas e o momento exato em que algo desaba. Para abri-lo:

• Chrome: Cmd + Option + J no Mac, Ctrl + Shift + J no Windows — ou clique com o botão direito em qualquer lugar, escolha Inspecionar e clique na aba Console
• Firefox: Cmd + Option + K no Mac, Ctrl + Shift + K no Windows
• Safari: ative primeiro o menu Desenvolvedor (Ajustes, Avançado, "Mostrar menu Desenvolvedor") e depois use Cmd + Option + C

Duas abas importam. Console mostra erros e logs — comece por aqui sempre que algo não estiver funcionando. Network (Rede) mostra cada requisição que o seu app faz aos servidores — use-a quando o login falhar ou os dados não carregarem: recarregue a página, procure linhas em vermelho, clique numa delas para ver os detalhes. E não, você não quebra nada só de olhar. O console é somente leitura por padrão.

Como ler mensagens de erro: a anatomia

Mensagens de erro parecem intimidadoras porque são escritas para desenvolvedores que conhecem o jargão. Mas elas 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 na mesma ordem:

1. O tipo de erro. A categoria: um TypeError significa que você está usando algo do jeito errado, um ReferenceError significa que você está usando algo que não existe, um SyntaxError significa que o código tem um erro de digitação, um NetworkError significa que o app não consegue alcançar um servidor.
2. A descrição. O problema específico em uma linha — "Cannot read property of undefined" significa que o código tentou usar dados que ainda não estão lá.
3. A localização. Um nome de arquivo, um número de linha e uma posição de caractere. Essa é a parte mais útil: ela te diz exatamente onde olhar.
4. A pilha de chamadas. A cadeia de chamadas de funções que levou ao erro. Normalmente você só se importa com as primeiras linhas que mencionam arquivos que você reconhece — o resto é código interno de bibliotecas que você pode ignorar.

O método dos 30 segundos: leia a primeira linha para saber o que deu errado, encontre o primeiro nome de arquivo que você reconhece para saber onde, e ignore tudo o que menciona o interior de bibliotecas.

Vermelho, amarelo, cinza: o que as cores significam

O console codifica tudo por cores de acordo com a gravidade, o que te diz o que merece a sua atenção:

• Vermelho = erro. Algo quebrou agora e o app não consegue continuar. Pare e corrija.
• Amarelo = aviso. Funciona hoje, mas pode quebrar depois ou ter desempenho ruim. Corrija quando puder — avisos não vão parar o seu app.
• Branco ou cinza = informação. Logs normais. Algumas bibliotecas são simplesmente tagarelas. Ignore.

Um console cheio de mensagens não é automaticamente ruim. Foque nas vermelhas, anote as amarelas e ignore o resto.

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 →

Os seis erros que você vai de fato ver (decifrados)

Construindo um SaaS com ferramentas de IA como Claude e Supabase, o mesmo punhado de erros responde por quase tudo. Aqui está a tradução em português claro:

Os códigos de status seguem uma regra: qualquer coisa na casa dos 200 significa sucesso, os 400 significam que você fez algo errado (dados ruins, não logado, sem permissão, endereço errado) e os 500 significam que o próprio servidor quebrou. Essa única regra decifra a aba Network inteira.

O que colar quando você pede ajuda à IA

É aqui que ler erros compensa. Quando você entrega um erro ao Claude, a qualidade da resposta é decidida pelo que você cola. Três coisas, sempre:

1. A mensagem de erro completa — incluindo o nome do arquivo e o número da linha, copiada direto do console (clique com o botão direito na mensagem, Copiar)
2. O código em volta do erro — mais ou menos cinco linhas antes e depois da linha que o erro aponta
3. O que você estava fazendo — uma frase: "Eu estava tentando carregar a página de perfil depois de fazer login"

Com essas três coisas, a IA corrige a maioria dos erros na primeira tentativa. Sem elas, ela chuta — e uma IA chutando é como você acaba na bagunça descrita em os sinais de que a IA está errada com toda a confiança. Se o mesmo erro continua voltando, ou se você está preso num cenário em vez de num erro isolado, o post seguinte percorre os dez problemas mais comuns ao construir com IA e as suas soluções.

Erros não são o inimigo. São o app te dizendo exatamente do que precisa. Os fundadores que entregam não são os que nunca veem texto vermelho — são os que pararam de ter medo dele.

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

Perguntas frequentes

Preciso entender de código para ler mensagens de erro?

Não. Você precisa reconhecer as quatro partes — tipo, descrição, localização, pilha de chamadas — e copiá-las com precisão. O tipo e a descrição do erro ficam quase claros depois que você vê os mais comuns, e a localização é só um nome de arquivo e um número de linha. A IA faz o resto.

Posso quebrar o meu app usando o console do navegador?

Não. As ferramentas de desenvolvedor são somente leitura por padrão — você está olhando os bastidores, não rearrumando o cenário. Você pode abrir o console, navegar pelas abas e copiar mensagens sem nenhum risco para o seu app ou os seus dados.

Quais erros devo corrigir primeiro?

Os erros vermelhos que bloqueiam fluxos essenciais: erros de rede, de autenticação, de banco de dados e qualquer coisa que produza uma tela em branco. Os avisos amarelos podem esperar. Os logs cinza de informação não exigem nenhuma ação — são só o app narrando o dia dele.

E se o console não mostrar erros, mas o app continuar se comportando mal?

Confira a aba Network em busca de linhas vermelhas — uma requisição que falhou nem sempre gera um erro visível no console. Se a rede também estiver limpa, provavelmente os dados estão sendo filtrados em vez de falhar: conta errada, registros inativos ou uma flag de rascunho. Esse cenário e outros nove estão decifrados no guia de problemas comuns ao construir com IA.