Error listen EADDRINUSE «address already in use»: descobrir quem tem a porta

A aplicação não arranca e a mensagem diz Error: listen EADDRINUSE: address already in use :::3000. Em Python, a versão é OSError: [Errno 98] Address already in use. A resposta curta: há outro processo a ouvir nessa porta, e só um programa pode ouvir numa porta de cada vez. Quase sempre é a mesma aplicação, ainda a correr de uma tentativa anterior. Este artigo é para um VPS; na hospedagem partilhada o caso é outro (veja o fim).

Descobrir quem tem a porta

1 Veja quem ouve na porta (aqui a 3000; troque pela sua): sudo ss -tlnp | grep :3000A última coluna mostra o nome do programa e o número do processo (pid=1234). Se não aparecer nada, a porta já está livre e o erro era de uma tentativa anterior.
2 Perceba o que é. Se for um node ou python da sua aplicação, é uma instância antiga. Se for outra coisa (o nginx, um contentor Docker), a porta está mesmo reservada para esse serviço e a sua aplicação tem de usar outra.
3 Pare a instância antiga com cuidado. Se a gere o PM2 ou o systemd, pare por lá: pm2 stop nome ou sudo systemctl stop nome. Só se for um processo solto, termine-o com kill 1234 (o número do pid). Use kill -9 apenas se o primeiro não resultar.
4 Arranque outra vez e confirme com o mesmo comando do passo 1.

As causas por trás

Causa Como se reconhece O que fazer
Duas instâncias da mesma aplicação O ss mostra o seu node; pm2 list tem a aplicação duas vezes, ou há uma a correr à mão e outra no serviço. Fique só com uma: o PM2 ou o systemd, não os dois, e não uma sessão aberta ao mesmo tempo.
Serviço a reiniciar-se em ciclo O estado do serviço oscila e o registo repete o erro. Pare o serviço, resolva a porta, volte a arrancar. Veja ler o systemctl status.
Um contentor publica a mesma porta docker ps mostra a porta publicada. Mude a porta da esquerda no -p: o seu primeiro contentor.
Outro programa legítimo O ss mostra um serviço que conhece. Escolha outra porta para a sua aplicação. Abaixo de 1024 só o root pode ouvir.
Desenvolvimento com recarga automática Um processo antigo ficou preso depois de um erro. Termine o processo antigo, como no passo 3.
Não mate às cegas o processo que o ss mostra. Confirme o que é antes: pode ser o nginx ou a base de dados, e parar isso deita abaixo outros sites. Em caso de dúvida, pergunte a quem montou o servidor. Num VPS não gerido, a gestão dos processos é sua: até onde vai o nosso suporte.
Na hospedagem partilhada (cPanel) não escolhe portas: o Passenger liga o domínio à aplicação. Se aí vir este erro, é porque o código tenta abrir um segundo servidor, ou uma porta fixa com um servidor antigo ainda vivo. Use process.env.PORT || 3000 no listen e reinicie pelo botão do ecrã da aplicação. Para o resto, veja portas e firewall num VPS.

Fez tudo isto e a porta continua ocupada? Envie-nos o resultado do ss e o nome do serviço.

Abrir um pedido de suporte

VEJA TAMBÉM

Portas e firewall num VPS: porque a aplicação não é alcançável

Manter uma aplicação Node.js a correr num VPS com o PM2

Um serviço não arranca no meu VPS: ler o systemctl status

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?

Artigos Relacionados

Pôr uma aplicação Django a correr O Django não está no instalador de aplicações do cPanel, e não é falta: aquele instalador é para aplicações em PHP. O Dj...
Pôr uma aplicação Ruby on Rails a correr O Ruby on Rails não está no instalador de aplicações do cPanel, porque aquele instalador é para aplicações em PHP. O Rub...
Instalar o Tomcat num servidor seu Não há Java nem Tomcat nos nossos servidores de hospedagem compartilhada, e não é possível instalá-los lá. Uma aplicação...
Configurar o Tomcat: portos, memória e o servidor à frente dele Continua a ser matéria de VPS ou servidor dedicado com acesso de administrador. Nos nossos servidores de hospedagem comp...
Pôr uma aplicação Node.js a correr Sim, há Node.js neste hospedagem. Não é um extra que se peça nem uma coisa de VPS: está no cPanel do cliente, na secção...
Escrever um Dockerfile para uma aplicação Node.js ou Python O Dockerfile é a receita que transforma a sua aplicação numa imagem: um pacote com o código, as bibliotecas e o ambiente...