본문 바로가기
더밸류노트
IT / 소프트웨어

'address already in use' 포트 3000 충돌 — 누가 쓰는지 찾고 비우는 법

개발 서버를 켰는데 EADDRINUSE(address already in use :::3000) 오류가 날 때, netstat -ano와 tasklist, Get-NetTCPConnection으로 포트를 쓰는 프로그램을 찾고 종료한 뒤 다시 띄우기까지 직접 재현한 과정을 정리했습니다.

3분 읽기
목차04
  1. 같은 포트로 두 번째 서버를 띄우면
  2. 포트 번호로 PID 찾기: netstat → tasklist
  3. PowerShell로 한 번에: 실행 파일 경로까지
  4. 끄기 전에 확인할 것

개발 서버를 실행했는데 Error: listen EADDRINUSE: address already in use :::3000 이 뜨고 바로 꺼진다면, 3000번 포트를 이미 다른 프로그램이 쓰고 있다는 뜻이다. 대부분은 예전에 띄워 두고 잊은 서버이거나, 창을 닫았는데 뒤에서 계속 돌고 있는 프로세스다. 이 PC(윈도우 11 Home, Node.js v24.11.0)에서 같은 상황을 일부러 만들고, 범인을 찾아 포트를 비우기까지 해 봤다(2026년 11월 3일). 테스트용 서버는 C:\port-test\server.js 에 한 줄짜리로 만들고, 하나를 창 없이 뒤에서 먼저 띄워 뒀다.

같은 포트로 두 번째 서버를 띄우면

node C:\port-test\server.js

node 실행 결과 Error: listen EADDRINUSE: address already in use :::3000 과 code 'EADDRINUSE', errno -4091, syscall 'listen', address '::', port 3000

맨 위 줄과 아래 묶음만 보면 된다.

  • EADDRINUSE — Node.js 문서의 설명으로는 "주소가 이미 사용 중"
  • address: '::', port: 3000 — 모든 주소의 3000번에 붙으려다 실패했다
  • 중간의 at ... 줄들은 오류가 난 코드 위치라 이번 문제와는 상관없다

창 없이 뒤에서 도는 서버는 작업 표시줄에도 안 보이기 때문에, 화면만 봐서는 누가 쓰는지 알 수 없다.

포트 번호로 PID 찾기: netstat → tasklist

명령 프롬프트에서 3000번을 쓰는 연결을 찾고, 끝 열의 번호(PID)로 프로그램 이름을 확인했다.

netstat -ano | findstr :3000
tasklist /fi "pid eq 6124"

netstat -ano | findstr :3000 결과 TCP 0.0.0.0:3000 LISTENING 6124, TCP [::]:3000 LISTENING 6124. tasklist 결과 node.exe PID 6124 Console 메모리 32,940 K

  • 상태가 LISTENING 인 줄이 서버다. 끝의 6124 가 PID
  • 같은 6124가 0.0.0.0:3000(IPv4)과 [::]:3000(IPv6) 두 줄로 나왔다. 서버가 두 개가 아니라 node 하나가 두 주소로 받고 있는 것이다
  • tasklist로 보니 node.exe, 메모리 32,940K

findstr :3000 은 글자를 찾는 것이라 :30000 이나 상대방 주소의 :3000 도 같이 걸릴 수 있다. 왼쪽(로컬 주소) 열이 :3000 으로 끝나는 LISTENING 줄만 보면 된다.

PowerShell로 한 번에: 실행 파일 경로까지

같은 프로그램이 여러 개 떠 있으면 이름만으로는 어느 것인지 헷갈린다. PowerShell에서는 포트로 바로 찾고 실행 파일 경로까지 볼 수 있다. 확인한 다음 PID로 끝내고 서버를 다시 띄웠다.

powershell -NoProfile -Command "Get-NetTCPConnection -LocalPort 3000 -State Listen | Select-Object LocalAddress, LocalPort, OwningProcess, @{n='Process';e={(Get-Process -Id $_.OwningProcess).Path}}"
taskkill /f /pid 6124
start /b node C:\port-test\server.js

Get-NetTCPConnection 결과 LocalAddress ::, LocalPort 3000, OwningProcess 6124, Process C:\Program Files\nodejs\node.exe. taskkill /f /pid 6124 성공: 프로세스(PID 6124)가 종료되었습니다. 다시 실행한 서버 listening on 3000

  • PowerShell은 :: 한 줄로 보여 줬다(netstat의 두 줄과 같은 소켓)
  • 실행 파일은 C:\Program Files\nodejs\node.exe
  • taskkill /f 는 "종료되었습니다"로 끝났다. /f 없이 쓰면 "종료 신호를 보냈습니다"만 뜨고 실제로 끝나기까지 시간이 걸릴 수 있다. 이 차이는 파일 사용 중이라 삭제가 안 될 때에서 직접 겪었다
  • 다시 띄운 서버는 listening on 3000 으로 정상 시작

확인이 끝난 뒤 테스트 서버를 끄고 폴더를 지웠다.

끄기 전에 확인할 것

찾은 프로그램판단
내가 예전에 띄운 개발 서버(node, python 등)그 창을 찾아 Ctrl+C로 끄거나 PID로 종료
편집기·IDE의 자식 프로세스편집기에서 실행 중인 작업을 멈추는 게 안전
모르는 프로그램, 서비스(svchost 등)끄지 말고 내 서버의 포트를 바꾼다

포트를 바꾸는 방법은 프로그램마다 다르다. 이 테스트 서버처럼 코드에 3000이 박혀 있으면 코드를 고치고, 개발 도구는 보통 실행 옵션이나 환경 변수(예: PORT)로 바꾼다. 그 도구의 설명서를 확인하면 된다.

한 가지 더. netstat 결과에서 0.0.0.0 이나 [::] 로 열린 서버는 같은 와이파이의 다른 기기에서도 접속을 받을 수 있는 상태다. 내 PC에서 바깥으로 열린 포트를 전부 점검하는 방법은 내 PC에서 바깥으로 열린 포트 찾기에 정리했다. netstat·tasklist 옵션 설명은 마이크로소프트 netstat, tasklist 문서에 있다.

자주 묻는 질문

03
EADDRINUSE는 무슨 뜻인가요?

Node.js 문서 기준으로 '주소가 이미 사용 중'이라는 뜻이며, 서버를 띄우려는 포트를 다른 서버가 이미 쓰고 있을 때 납니다.

netstat 결과에 같은 PID가 두 줄 나오는 건 왜인가요?

이 PC에서는 node 하나가 0.0.0.0:3000(IPv4)과 [::]:3000(IPv6) 두 줄로 나왔습니다. 프로그램이 두 개 떠 있는 게 아니라 한 프로세스가 두 주소로 받는 것입니다.

프로그램을 끄지 않고 해결할 수는 없나요?

새로 띄우는 쪽의 포트를 바꾸면 됩니다. 다만 이미 떠 있는 서버가 예전에 띄워 두고 잊은 것이라면, 그 서버를 끄는 편이 헷갈리지 않습니다.

참고 자료

  1. netstat - Microsoft Learn
  2. tasklist - Microsoft Learn
  3. Node.js Errors — Common system errors

같은 카테고리의 글

04