Erros Comuns em Go: Guia de Referência

Quando você programa em Go, inevitavelmente encontra mensagens de erro — seja do compilador, do runtime ou de ferramentas como o go vet e o race detector. Este guia reúne os erros mais frequentes que desenvolvedores Go enfrentam no dia a dia, com explicações claras e soluções práticas.

Se você está começando com Go, recomendamos primeiro ler nosso guia de tratamento de erros em Go, que explica os fundamentos da abordagem de erros da linguagem. Este guia complementa aquele conteúdo, focando nas mensagens de erro específicas que você encontra durante o desenvolvimento.

Erros de Compilação

Estes erros aparecem antes do seu programa executar. O compilador do Go é rigoroso e detecta muitos problemas antecipadamente.

Tipos e Valores

• cannot use X as type Y — Quando você tenta atribuir ou passar um valor de tipo incompatível. Um dos erros mais frequentes, especialmente para quem vem de linguagens com tipagem dinâmica.

• declared and not used — Variáveis declaradas que não são utilizadas. Exclusivo do Go e uma surpresa comum para iniciantes.

• missing return at end of function — Quando uma função declara valores de retorno, mas nem todos os caminhos de execução retornam um valor.

• multiple-value in single-value context — Quando você tenta usar o resultado de uma função que retorna múltiplos valores em um contexto que espera apenas um.

Referências e Escopo

• undefined: variable or function — Referências a variáveis, funções ou campos que não existem no escopo atual, incluindo nomes não exportados de outros pacotes.

• import cycle not allowed — Dependência circular entre pacotes. O compilador do Go não permite ciclos de importação.

Iteração

• cannot range over X — Quando você tenta usar range com um tipo que não suporta iteração.

Erros de Runtime

Estes erros acontecem durante a execução do programa. São mais difíceis de prever porque dependem dos dados e do estado do programa.

• nil pointer dereference — O temido panic por acessar um ponteiro nulo. Uma das causas mais comuns de crashes em programas Go.

• all goroutines are asleep — deadlock! — Quando todas as goroutines do programa estão bloqueadas esperando umas pelas outras.

• data race detected — Acesso concorrente a memória compartilhada sem sincronização, detectado pelo race detector do Go.

Como Usar Este Guia

Cada página de erro contém:

1. A mensagem de erro exata — para você identificar rapidamente
2. O que causa o erro — explicação clara do motivo
3. Código de exemplo — reproduzindo o erro
4. Como resolver — soluções práticas com código corrigido
5. Dicas adicionais — boas práticas para evitar o erro no futuro

Recursos Relacionados

Se você quer aprofundar seus conhecimentos sobre erros em Go, confira estes recursos:

• Tratamento de Erros em Go: Guia Definitivo — Fundamentos de error handling
• Testes em Go: Guia Completo — Como testar seu código e prevenir erros
• Go para Iniciantes — Primeiros passos na linguagem
• Concorrência em Go — Entenda goroutines e channels para evitar deadlocks e race conditions
• Interfaces em Go — Compreenda a interface error e tipagem em Go
• Perguntas de Entrevista Go — Erros e error handling são temas frequentes em entrevistas