¿Qué significa "listen EADDRINUSE: address already in use"?

Otro proceso ya está escuchando en ese puerto, así que tu servidor no puede usarlo. Suele ocurrir cuando un servidor de desarrollo anterior no se cerró correctamente.

¿Cómo libero un puerto que ya está en uso?

Encuentra el proceso con lsof -i :PUERTO en macOS/Linux (o netstat -ano | findstr :PUERTO en Windows) y termínalo con kill -9 PID (o taskkill /PID pid /F), o arranca tu servidor en otro puerto.

EADDRINUSE: address already in use — cómo liberar el puerto

Respuesta rápida

Otro proceso ya está escuchando en el puerto. Encuéntralo con lsof -i :3000 (macOS/Linux) o netstat -ano | findstr :3000 (Windows), termínalo con kill -9 <PID> (o taskkill /PID <pid> /F en Windows) y vuelve a arrancar tu servidor — o simplemente ejecútalo en otro puerto.

Si intenta iniciar un servidor en un puerto que ya está siendo utilizado por otro programa, obtendrá el siguiente error:

MAKINOTE$ yarn start
yarn run v1.22.19
$ next start
Error: listen EADDRINUSE: address already in use 0.0.0.0:3000
    at Server.setupListenHandle [as _listen2] (node:net:1432:16)
    at listenInCluster (node:net:1480:12)
    at doListen (node:net:1629:7)
    at processTicksAndRejections (node:internal/process/task_queues:84:21) {
  code: 'EADDRINUSE',
  errno: -48,
  syscall: 'listen',
  address: '0.0.0.0',
  port: 3000
}

Encuentra el proceso que está usando el puerto

MAKINOTE$ lsof -i :3000
COMMAND   PID                 USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
node    38091 xabier.lameirocardam   24u  IPv6 0xee02297dd086ebc1      0t0  TCP *:hbci (LISTEN)

Mata el proceso

MAKINOTE$ kill -9 38091