The Stack Trace Decoder: Cole qualquer erro, obtenha a causa raiz + correção em segundos

The Prompt

Estou depurando um erro. Me ajude a entender o que deu errado e como corrigir.

**Mensagem de erro:**
[COLE A MENSAGEM DE ERRO AQUI]

**Stack trace:**
[COLE O STACK TRACE COMPLETO AQUI]

**Código relevante (função/arquivo onde o erro se origina):**
```
[COLE O CÓDIGO AQUI]
```

**Contexto:**
- Linguagem/ambiente: [ex: Python 3.11, Node.js 22, Go 1.22]
- O que eu estava tentando fazer quando o erro ocorreu: [uma frase]
- O que já tentei: [ou "nada ainda"]

Por favor, forneça:
1. **Causa raiz** — explique em linguagem clara o que realmente quebrou e por quê
2. **A correção** — mostre o código corrigido com comentários inline explicando a mudança
3. **Por que isso aconteceu** — o mecanismo subjacente ou equívoco que causou o bug, para que eu entenda, não apenas copie a correção
4. **Prevenção** — uma frase sobre como evitar essa classe de erro no futuro

Como Usar

Copie o template acima. Preencha as quatro seções — mensagem de erro, stack trace, código e contexto. Quanto mais completo o stack trace, melhor o diagnóstico. Você não precisa editar ou limpar; cole como está.

A seção de contexto é opcional, mas vale a pena preencher. "O que eu estava tentando fazer" ajuda o modelo a entender a intenção. "O que já tentei" evita que ele sugira coisas que você já descartou.

O Que Você Recebe de Volta

A estrutura de resposta em quatro partes foi desenhada especificamente para evitar os dois modos de falha mais comuns da ajuda de depuração com IA:

• A correção cega — dar código corrigido sem explicar por que o original estava errado. Você aplica, funciona, mas não entende e repete o mesmo padrão em outro arquivo na semana seguinte.
• O diagnóstico vago — "parece que pode haver um problema de referência nula." Sem detalhes, sem correção, sem caminho a seguir.

A saída estruturada força especificidade: causa raiz primeiro (o que está realmente quebrado), depois a correção com comentários inline (não apenas um dump de código), depois o mecanismo (o porquê por trás do porquê), depois a prevenção (uma regra que você pode internalizar).

Funciona em Várias Linguagens

Este prompt é agnóstico em relação à linguagem. Funciona bem com:

• Python — ótimo para tracebacks, erros de import, erros de tipo, problemas com async/await
• JavaScript / TypeScript — lida com erros do Node.js, exceções do console do navegador, erros do compilador TypeScript
• Go — pânicos em runtime, stack traces de goroutines, falhas em asserção de interface
• Java / Kotlin — cadeias de NullPointerException, stack traces da JVM, erros de contexto do Spring
• Rust — mensagens de erro do compilador (que já são detalhadas, mas ainda se beneficiam de explicação)
• SQL — erros de análise de consulta, violações de constraint, traces de deadlock do PostgreSQL/MySQL

Para linguagens compiladas onde o stack trace é menos informativo, cole a saída completa do compilador junto com o erro.

Exemplo de Entrada e Saída

Entrada (simplificada):

Mensagem de erro: TypeError: Cannot read properties of undefined (reading 'map')

Stack trace:
  at ProductList (ProductList.jsx:14:22)
  at renderWithHooks (react-dom.development.js:14985:18)

Código relevante:
function ProductList({ products }) {
  return (
    <ul>
      {products.map(p => <li key={p.id}>{p.name}</li>)}
    </ul>
  );
}

Contexto: React 18, Node 22. Tentando renderizar uma lista obtida de uma API.

Como é uma boa resposta:

• Causa raiz: products é undefined quando o componente renderiza pela primeira vez, antes da resposta da API chegar. .map() não pode executar em undefined.
• Correção: Adicione um valor padrão — function ProductList({ products = [] }) — ou adicione uma guarda de null antes do map.
• Por que isso aconteceu: React renderiza de forma síncrona antes que as chamadas assíncronas de dados sejam resolvidas. O componente renderiza com qualquer valor inicial que o pai passe, que é undefined se o pai não definiu um estado inicial ainda.
• Prevenção: Sempre inicialize props de lista com um array vazio padrão e lide explicitamente com estados de loading/vazio no componente.

Dicas para Melhores Resultados

• Cole o stack trace completo, não apenas a linha de cima. Quadros inferiores muitas vezes revelam a chamada real que disparou o erro.
• Inclua o código imediatamente ao redor, não apenas a linha que deu erro. Algumas linhas de contexto acima e abaixo importam.
• Se o erro é intermitente, diga — o modelo vai considerar condições de corrida e problemas de temporização.
• Para erros de TypeScript, inclua as configurações relevantes do tsconfig.json se o erro for sobre strictness ou resolução de módulos.