Error: listen EADDRINUSE: address already in use :::5000

NodeJS에서 스크립트를 실행하기 위해 npm run을 통해 명령을 실행하면 아래와 같이 에러가 발생하며 진행되지 않는 경우가 있습니다.

node:events:491
       throw er; // Unhandled 'error' event
       ^
 
 Error: listen EADDRINUSE: address already in use :::5000
     at Server.setupListenHandle [as _listen2] (node:net:1485:16)
     at listenInCluster (node:net:1533:12)
     at Server.listen (node:net:1621:7)
     at Application.listen (/Users/user/webProject/node_modules/koa/lib/application.js:82:19)
     at file:///Users/user/webProject/server.js:105:7
     at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
 Emitted 'error' event on Server instance at:
     at emitErrorNT (node:net:1512:8)
     at process.processTicksAndRejections (node:internal/process/task_queues:82:21) {
   code: 'EADDRINUSE',
   errno: -48,
   syscall: 'listen',
   address: '::',
   port: 5000
 }
 
 Node.js v18.12.1
 [nodemon] app crashed - waiting for file changes before starting...
 event - compiled client and server successfully in 1068 ms (1541 modules)
 npm run server-dev exited with code 0
 npm run client exited with code 0

이 문제는 스크립트를 실행하는 호스트에서 5000번 포트가 이미 다른 프로세스에 의해 사용 중이기 때문에 해당 포트를 사용하지 못하여 발생하는 문제입니다. 만약 위 에러 메시지에서 5000 대신 다른 번호가 나왔다면, 마찬가지로 해당 번호의 포트를 어딘가에서 사용해서 발생하는 문제일 것입니다.

해결 방법

Error: listen EADDRINUSE: address already in use :::5000 문제의 해결 방법은 간단합니다. 5000번 포트를 사용하는 다른 프로세스를 찾아 종료하고 재시도하거나, 스크립트에서 사용하는 포트를 5000번 이외의 다른 포트를 지정하여 시도해보는 방법이 있습니다.

다만 여기서 예외로 macOS를 사용 중인 경우 특별히 사용 중인 프로그램이 없음에도 5000번 포트를 사용하지 못하는 경우가 있습니다.

lsof 명령어를 사용하여 현재 5000번 포트를 사용하는 프로세스의 PID를 알 수 있습니다.

$ lsof -i :5000
COMMAND   PID USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
ControlCe 400  user    7u  IPv4 0x889f60216f5c263f      0t0  TCP *:commplex-main (LISTEN)
ControlCe 400  user    8u  IPv6 0x889f602cc344a274      0t0  TCP *:commplex-main (LISTEN)

여기서는 400번 PID를 사용하는 프로세스가 사용 중이라고 검색됩니다. ps 명령어를 통해 400번 PID인 프로세스를 찾습니다.

$ ps -aef | grep 400
  501   400     1   0 11:42AM ??         2:17.53 /System/Library/CoreServices/ControlCenter.app/Contents/MacOS/ControlCenter

ControlCenter.app에서 사용 중인 것을 확인할 수 있습니다. 이 앱은 macOS에서 사용하는 설정 관련 앱입니다. macOS에서는 에어드롭(AirDrop) 기능에서 사용하는 에어플레이(AirPlay)라는 기능에서 특정 포트를 사용하는데, 하필 이게 5000번 포트 또한 사용하고 있었던겁니다.

AirDrop의 AirPlay 기능을 사용하지 않는다면 이 기능을 꺼보도록 하겠습니다.

먼저 상단 메뉴에서 애플 로고를 클릭한 후 시스템 설정을 클릭하여 들어갑니다.

다음으로 좌측 메뉴에서 일반 그룹을 클릭한 후 ‘AirDrop 및 Handoff’ 메뉴를 클릭합니다.

AirDrop 및 Handoff 옵션에서 ‘AirPlay 수신 모드’ 옵션이 활성화 되어 있는 것을 확인할 수 있습니다. 버튼을 클릭하여 기능을 비활성화 하도록 합니다.

이제 해당 기능을 사용하지 않으므로 5000번 포트를 다시 사용할 수 있을 것입니다.