'address already in use' 포트 3000 충돌 — 누가 쓰는지 찾고 비우는 법
개발 서버를 켰는데 EADDRINUSE(address already in use :::3000) 오류가 날 때, netstat -ano와 tasklist, Get-NetTCPConnection으로 포트를 쓰는 프로그램을 찾고 종료한 뒤 다시 띄우기까지 직접 재현한 과정을 정리했습니다.
개발 서버를 실행했는데 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

맨 위 줄과 아래 묶음만 보면 된다.
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](https://mhkznvizedghxjrgckgk.supabase.co/storage/v1/object/public/valuenote/posts/windows-port-already-in-use-eaddrinuse-netstat/02-netstat.png)
- 상태가 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

- 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 문서에 있다.
자주 묻는 질문
03EADDRINUSE는 무슨 뜻인가요?
Node.js 문서 기준으로 '주소가 이미 사용 중'이라는 뜻이며, 서버를 띄우려는 포트를 다른 서버가 이미 쓰고 있을 때 납니다.
netstat 결과에 같은 PID가 두 줄 나오는 건 왜인가요?
이 PC에서는 node 하나가 0.0.0.0:3000(IPv4)과 [::]:3000(IPv6) 두 줄로 나왔습니다. 프로그램이 두 개 떠 있는 게 아니라 한 프로세스가 두 주소로 받는 것입니다.
프로그램을 끄지 않고 해결할 수는 없나요?
새로 띄우는 쪽의 포트를 바꾸면 됩니다. 다만 이미 떠 있는 서버가 예전에 띄워 두고 잊은 것이라면, 그 서버를 끄는 편이 헷갈리지 않습니다.
참고 자료
같은 카테고리의 글
04python3를 치면 'Python'만 나오거나 스토어가 열릴 때 — 앱 실행 별칭과 PATH
파이썬을 설치했는데 python3 명령이 'Python' 한 단어만 출력하고 끝나거나 Microsoft Store가 열릴 때, 원인인 앱 실행 별칭(0바이트 python3.exe)과 PATH 순서, py 런처로 버전을 고르는 방법을 직접 확인해 정리했습니다.
3분디스크 정리 4.39GB vs 설정 앱 임시 파일 37.8GB — 같은 PC인데 숫자가 9배 다른 이유
cleanmgr로 C드라이브를 계산해 '최대 4.39GB'와 기본 체크 323MB를 확인하고, 설정 앱의 임시 파일 37.8GB·추천 정리 5.00GB와 나란히 비교했습니다. 두 도구가 세는 범위가 다른 이유와 체크하기 전에 볼 항목을 직접 확인한 화면으로 정리했습니다.
3분'다른 프로세스가 파일을 사용 중' 삭제 안 될 때 — 잡고 있는 프로그램 찾는 법
파일 삭제·이름 바꾸기가 '다른 프로세스가 파일을 사용 중이기 때문에' 오류로 막힐 때, openfiles가 안 되는 이유와 PowerShell로 파일을 잡은 프로그램(PID)을 찾는 방법, taskkill 직후 다시 실패했던 이유를 직접 재현해 정리했습니다.
4분내 PC에서 바깥으로 열린 포트 찾기 — 대기 중 50개 중 31개, 개발 서버는 공용 와이파이에도 열려 있었다
Get-NetTCPConnection으로 대기 중인 포트 50개를 세어 PC 안 전용(127.0.0.1)과 바깥으로 열린 31개를 나누고, node 개발 서버에 걸린 방화벽 허용 규칙(Private·Public)과 네트워크 프로필까지 확인한 과정을 화면과 함께 정리했습니다.
3분