~ / hub / erros / Too many open files (EMFILE)
4 out 2026errosguia de solução

Too many open files (EMFILE)

O processo esgotou o limite de arquivos e sockets abertos.

1. Significado

No Linux, arquivos, sockets e pipes usam descritores de arquivo. Cada processo tem um limite (nofile), que muitas distribuições deixam em 1024 por padrão. Servidores com muitas conexões simultâneas chegam nele rápido e passam a falhar com EMFILE: too many open files (Node), OSError: [Errno 24] (Python) ou mensagens parecidas em Nginx e bancos.

2. Ver o limite e o uso atual

ulimit -n                         # limite da sessão atual
cat /proc/PID/limits | grep "open files"   # limite de um processo em execução
ls /proc/PID/fd | wc -l           # quantos descritores ele usa agora
sudo lsof -p PID | wc -l

Veja detalhes em lsof.

3. Aumentar o limite

Serviço no systemd (o jeito certo para serviços):

sudo systemctl edit minha-api
# adicione:
[Service]
LimitNOFILE=65535

sudo systemctl restart minha-api

Sessões de usuário (login shell), em /etc/security/limits.conf:

ana  soft  nofile  65535
ana  hard  nofile  65535

Em contêineres Docker: docker run --ulimit nofile=65535:65535 .... Para Nginx, ajuste também worker_rlimit_nofile e worker_connections.

4. Aumentar não resolve vazamento

Se o número de descritores só cresce ao longo do tempo, há vazamento: arquivos ou conexões não fechados. Compare ls /proc/PID/fd | wc -l em momentos diferentes e use lsof para ver o tipo (sockets em CLOSE_WAIT, arquivos de log, pipes).

  • Feche arquivos com with open(...) (Python) ou defer f.Close() (Go).
  • Reutilize conexões HTTP/banco com pool em vez de abrir uma por requisição.
  • Em Node, verifique streams não encerrados e watchers (vários fs.watch em muitos arquivos).
FERRAMENTAS DE DEV Em macOS e em watchers de editores, o erro aparece ao monitorar muitos arquivos; aumente o limite do sistema com a ferramenta correspondente (ulimit -n) e exclua node_modules do monitoramento.

Continue explorando

← erros · lsof · ss · systemctl · OOM killer

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →