2026년 최신 OS 업데이트 기준(Windows 11 및 macOS Sequoia/Linux)에 맞춘 포트 8080 확인 및 종료 명령어 가이드입니다. OS별 정확한 명령어와 실행 차단 시 해결책을 제공합니다.
웹 개발이나 백엔드 서버를 구동할 때 8080 포트가 이미 사용 중이라는 에러(Address already in use)는 빈번하게 발생합니다. Windows, macOS, Linux 환경에서 현재 8080 포트를 점유하고 있는 프로세스의 PID를 찾고, 이를 강제로 안전하게 종료하는 정확한 명령어를 정리했습니다.
Windows 환경에서 8080 포트 확인 및 종료 (CMD / PowerShell)
Windows 11 및 Server 환경에서는 netstat 명령어와 findstr을 조합하여 포트 점유 상태를 조회합니다.
1. 8080 포트 점유 프로세스(PID) 조회
명령 프롬프트(CMD) 또는 PowerShell을 관리자 권한으로 실행한 후 아래 명령어를 입력합니다.
-a: 모든 연결 및 대기 포트를 표시합니다.
-n: 주소와 포트 번호를 숫자로 표시하여 탐색 속도를 높입니다.
-o: 각 연결에 소유자 프로세스 ID(PID)를 표시합니다.
출력 결과 예시:
분석: 상태가 LISTENING으로 표시되면 현재 포트가 사용 중인 상태이며, 가장 오른쪽 끝에 있는 숫자 14252가 해당 프로세스의 **PID(프로세스 ID)**입니다.
2. PID 기반 프로세스 이름 확인 (선택 사항)
종료하기 전 어떤 프로그램이 포트를 쓰고 있는지 확인하려면 아래 명령어를 입력합니다.
3. 8080 포트 강제 종료
확인된 PID를 이용해 해당 프로세스를 강제로 종료합니다.
macOS / Linux 환경에서 8080 포트 확인 및 종료
Unix 계열 OS에서는 lsof 명령어 또는 netstat 대안인 ss 명령어를 사용하는 것이 가장 정확합니다.
1. 8080 포트 점유 프로세스(PID) 조회
터미널을 열고 아래 명령어를 입력합니다. macOS의 경우 시스템 보호로 인해 sudo 권한이 필요할 수 있습니다.
또는 특정 IPv4 TCP 연결만 필터링하려면 아래 명령어를 사용합니다.
출력 결과 예시:
분석: PID 열에서 현재 8080 포트를 차지하고 있는 프로세스 ID가 32145임을 확인할 수 있습니다.
2. 8080 포트 강제 종료
확인된 PID를 사용하여 프로세스에 시그널을 보내 종료합니다.
💡 단 한 줄로 조회 및 자동 종료하기 (macOS/Linux 전용)
PID를 따로 확인하고 입력하는 과정이 번거롭다면, 8080 포트를 쓰는 프로세스를 찾아 즉시 종료하는 단축 명령어를 쓸 수 있습니다.
포트 점유 해결 시 발생할 수 있는 문제와 해결책
| 발생 상황 | 원인 | 해결 방법 |
| Windows: 액세스가 거부되었습니다. | CMD/PowerShell을 일반 권한으로 실행함 | 시작 메뉴에서 '명령 프롬프트' 우클릭 후 [관리자 권한으로 실행] 선택 |
| Linux/macOS: 아무 결과도 안 나옴 | 해당 포트를 쓰는 프로세스가 이미 종료됨 | 포트가 비어있는 상태이므로 즉시 서버 재구동 가능 |
| 종료 후 바로 다시 포트가 차단됨 | IDE(VS Code, IntelliJ)나 스케줄러가 자동 재시작함 | 백엔드 애플리케이션의 디버그 모드 또는 모니터링 프로세스 자체를 종료 |
자주 묻는 질문
Q1. netstat 명령어 실행 시 ' findstr'은(는) 내부 또는 외부 명령이 아닙니다'라고 나옵니다.
Windows 환경 변수(Path)가 누락되었을 때 발생하는 현상입니다. 명령어를 C:\Windows\System32\findstr.exe와 같이 절대 경로로 지정하여 실행하거나, 시스템 환경 변수에 C:\Windows\System32를 추가해야 합니다.
Q2. macOS에서 lsof 명령어를 입력했는데 아무것도 출력되지 않지만 포트 에러가 납니다.
프로세스가 커널 및 다른 사용자 권한으로 실행 중일 때 일반 권한으로는 조회되지 않습니다. 명령어 앞에 반드시 sudo를 붙여 sudo lsof -i :8080으로 실행해야 전체 프로세스 조회가 가능합니다.
Q3. 포트를 강제 종료하면 개발 중이던 코드나 데이터가 유실되나요?
taskkill /F나 kill -9는 프로세스 메모리를 즉시 해제하므로, 저장되지 않은 내부 데이터나 비정기 캐시 데이터는 유실될 수 있습니다. 데이터 안전성이 중요하다면 인스턴스를 구동한 터미널에서 Ctrl + C를 통해 정상 종료(Graceful Shutdown)를 먼저 시도하십시오.
Q4. 8080 포트를 점유하고 있는 주요 프로그램은 보통 무엇인가요?
가장 대표적으로는 Apache Tomcat, Spring Boot, Node.js(Webpack dev server), Oracle Database(XDB 서비스) 등이 기본 포트로 8080을 사용합니다.
댓글
댓글 쓰기