~ / hub / erros / ELOOP — symlink loop
4 out 2026errosguia prático

ELOOP — symlink loop

Loop de links simbólicos.

ELOOP ocorre quando o kernel encontra um ciclo de links simbólicos ou ultrapassa o limite de hops ao resolver um caminho.

O que significa

Ao seguir symlinks (A → B → A, ou cadeia longa demais), a resolução do path falha com ELOOP em vez de abrir o alvo final.

Por que acontece

  • Symlinks circulares criados por engano
  • Cadeia excessivamente longa de links
  • Scripts de deploy que recriam links relativos de forma inconsistente

Como diagnosticar

namei -l path
readlink -f path

Substitua path pelo caminho problemático. namei mostra cada componente; se houver ciclo, a cadeia se repete.

Correção

Remova ou reaponte o symlink que fecha o ciclo. Evite links relativos confusos em árvores geradas automaticamente.

Relacionado: hub de erros.

DICA ln.

Continue explorando

← Erros · hub

Veja também o hub de conteúdo.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →