💥 Web server failed to start. Port 8080 was already in use

2026. 7. 20. 21:34·Troubleshooting

이 글은 Velog에서 이전한 글입니다. Velog 원문 보기

코딩을 하면서 'Web server failed to start. Port 8080 was already in use' 에러를 자주 봤다. 처음에는 "어떻게 해결하지?"라며 당황해 1시간이 걸려서 해결했지만 이제는 "또 이거구나..후"라고 생각하며 에러를 해결한다.

에러 원인과 메시지

에러가 생기는 원인

  • 포트가 이미 실행 중일 때 스프링을 실행하면 발생하는 에러
Web server failed to start. Port 3000 was already in use.
Action:
Identify and stop the process that's listening on port 3000 or configure this application to listen on another port.
2019-11-06 22:00:06.094  INFO 8996 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Shutting down ExecutorService 'applicationTaskExecutor'

또는

Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:2.2.0.RELEASE:run (default-cli) on project babyfoodchef: Application finished with exit code: 1

포트가 이미 실행 중일 때 스프링을 실행하면 위와 같은 에러 메시지가 나온다.

해결법

해결법은 간단하다. 포트가 이미 실행 중일 때 스프링을 실행하면서 생기는 오류이니 실행중인 포트를 끊어주면 된다.

Window의 경우

명령 프롬포트(CMD)에서 netstat -ano를 실행 하면 위의 사진 처럼 실행중인 포트들이 나온다.
3000 포트를 사용한다면 위의 빨간색 박스 포트의 PID인 2668을 종료시키면 되고, 8080 포트를 사용한다면 8080 포트의 PID를 종료시키면 된다.

taskkill /pid 2668 /f

Mac의 경우

맥의 터미널에 lsof -i tcp:8080를 실행하면 8080 포트로 실행중인 프로세스가 위 사진처럼 나온다.

lsof -i tcp:(포트)

윈도우와 마찬가지로 8080 포트로 실행중은 PID 번호인 2185를 종료시키면 된다.
sudo kill -9 2185

sudo kill -9 PID 번호


출처
https://dundung.tistory.com/148

'Troubleshooting' 카테고리의 다른 글

[시행착오] AWS 프리티어 비용 과금 이슈, 해결 방법  (0) 2026.07.29
💥 아! Get 요청시에는 Message body를 사용하면 안되는구나!!  (1) 2026.07.29
💥 [Error] JWT Token 인증 문제  (0) 2026.07.28
💥 [Error] Dirty Checking이 안되는 오류  (0) 2026.07.24
💥 Springboot Multipart 파일 업로드 용량 초과 에러  (0) 2026.07.21
'Troubleshooting' 카테고리의 다른 글
  • 💥 아! Get 요청시에는 Message body를 사용하면 안되는구나!!
  • 💥 [Error] JWT Token 인증 문제
  • 💥 [Error] Dirty Checking이 안되는 오류
  • 💥 Springboot Multipart 파일 업로드 용량 초과 에러
pp8817
pp8817
공부한 내용, 개발 관련 지식, 트러블 슈팅 등을 기록합니다. 이전 블로그: https://velog.io/@pp8817/posts
  • pp8817
    끄적이는 개발 log
    pp8817
  • 전체
    오늘
    어제
    • 분류 전체보기 (273)
      • Project (71)
        • 척척학사 (29)
        • Book (23)
        • Saynow (3)
        • YAPP 27기 (4)
        • 나의 작은 프로젝트 (10)
        • Landit (2)
      • Backend (88)
        • Spring (13)
        • Spring MVC (13)
        • Spring Security (4)
        • JPA (26)
        • Database (19)
        • HTTP·Web (13)
        • Architecture (0)
      • Language·CS (59)
        • Java·Kotlin (5)
        • CS Interview (17)
        • Backend Interview (5)
        • Concepts (32)
      • Algorithm (25)
        • Algorithm (24)
        • 소마 알고리즘 스터디 (1)
      • Infra (8)
      • Troubleshooting (11)
      • Retrospective (6)
      • Etc (5)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    나의 작은 프로젝트
    http
    OS
    interview
    BOJ
    Spring
    Book
    CS Interview
    척척학사
    java
    object
    게시판
    HTTP WEB 기본 지식
    jpa
    Spring MVC
    개념 정리!
    Algorithm
    트러블슈팅
    Python
    Project
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.6
pp8817
💥 Web server failed to start. Port 8080 was already in use
상단으로

티스토리툴바