E: address already in use :::3000

포트 3000이 이미 사용 중일 때 발생하는 오류.
실행 중인 터미널이 없더라도 백그라운드에서 해당 포트를 사용하고 있을 수 있다.

1.사용 중인 프로세스 확인

1) macOS / Linux

3000번 포트를 사용중인 프로세스 확인

lsof -i :3000

출력:

COMMAND   PID   USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
node     1234  user   22u  IPv6  0x...      0t0  TCP *:3000 (LISTEN)

2) Windows (PowerShell)

3000번 포트를 사용중인 프로세스 확인

netstat -ano | findstr :3000

출력:

TCP    127.0.0.1:3000    0.0.0.0:0    LISTENING    9876

2. 사용 중인 프로세스 종료

pid로 종료할 프로세스 지정

kill -9 1234 # macOS / Linux
taskkill /PID 9876 /F # Windows 관리자권한 필요