개발 중 Spring Boot 포트 충돌로 인한 오류를 만나면 당황할 수 있습니다.
특히 Mac에서 8080 포트가 이미 사용 중이라는 메시지를 볼 때가 많죠.
오늘은 Spring Boot 8080 오류를 쉽게 해결할 수 있는 방법을 단계별로 소개합니다.
1️⃣ 오류 메시지 분석: 왜 Spring Boot가 실행되지 않을까?
*************************** APPLICATION FAILED TO START *************************** Description: Web server failed to start. Port 8080 was already in use. Action: Identify and stop the process that's listening on port 8080 or configure this application to listen on another port. Process finished with exit code 1
이 오류는 Mac에서 Port 8080이 이미 사용 중이라는 의미입니다.
다른 애플리케이션이 8080 포트를 점유하고 있어 Spring Boot 애플리케이션이 충돌하는 것이죠.
이땐, 8080포트를 점유한 프로세스를 종료하거나 SpringBoot포트를 변경하는 방법으로 해결할 수 있습니다.
2️⃣ Mac에서 Port 8080 사용 프로세스 확인 및 종료하기
(1) 포트 8080을 점유한 프로세스를 확인
lsof -i :8080
실행 결과 예시
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME java 12345 user1 123u IPv6 0x1234567890abcdef 0t0 TCP *:http-alt (LISTEN)
COMMAND: 포트를 사용 중인 애플리케이션 (java, docker, node 등)
PID: 해당 프로세스의 프로세스 ID (12345)
USER: 프로세스를 실행한 사용자 (user1)
(2) 포트 8080를 점유한 프로세스를 종료
8080 포트를 점유한 프로세스의 PID를 가져와 Kill 명령어를 통해 프로세스를 종료합니다.
kill -9 12345 ## kill -9 [PID]⚠️ 주의: kill -9는 프로세스를 강제 종료합니다. 이 프로세스가 중요하지 않을 때만 사용하세요.
3️⃣ Spring Boot 포트 변경 방법
Spring Boot 포트 변경은 application.properties 또는 application.yml에서 간단히 설정할 수 있습니다.
8080 포트 대신 8081과 같은 다른 포트를 지정하세요.
application.properties
server.port=8081
application.yml
server: port: 8081
5️⃣ Mac 재부팅으로 간단히 해결하기
만약 명령어 사용이 익숙하지 않다면 Mac을 재부팅하는 것도 하나의 방법입니다.
재부팅하면 포트 충돌 문제가 자동으로 해결될 수 있습니다.
Mac에서 Spring Boot 8080 오류는 흔히 발생하는 문제이지만, 간단한 터미널 명령어나 포트 변경으로 손쉽게 해결할 수 있습니다.
다음에 같은 오류가 발생하더라도 오늘 소개한 방법을 적용해 보세요!