Spring Boot 포트 충돌 문제 해결 가이드

Spring Boot에서 포트 충돌 해결하기

안녕하세요! 오늘은 Spring Boot 개발 중 자주 마주치는 포트 충돌 문제를 해결하는 방법에 대해 알아보겠습니다. 특히, Mac OS에서 ‘Port 8080 is already in use’라는 오류 메시지를 마주했을 때 어떻게 대처할 수 있는지에 대해 설명드릴게요.

들어가며

Spring Boot는 많은 웹 애플리케이션에서 기본적으로 8080 포트를 사용하곤 합니다. 하지만 가끔 다른 프로세스가 이미 해당 포트를 사용 중이라면, 서버를 실행할 수 없게 됩니다. 이럴 때 우리는 어떤 방법을 통해 문제를 해결할 수 있을까요?

문제 발생 사례

예를 들어, IntelliJ IDEA에서 프로젝트를 빌드할 때 다음과 같은 오류 메시지를 볼 수 있습니다.

이 메시지는 8080 포트가 이미 사용 중이라는 것을 뜻합니다. 다음 단계로 이 포트를 차지하고 있는 프로세스를 확인해 보겠습니다.

프로세스 확인하기

터미널을 열고 아래 명령어를 입력합니다:

lsof -i tcp:8080

이 명령어는 현재 8080 포트를 사용 중인 프로세스의 리스트를 반환합니다. 해당 프로세스의 PID(프로세스 ID)를 확인하세요.

프로세스 종료하기

포트를 사용 중인 프로세스가 확인되었다면, 이제 그 프로세스를 종료시켜야 합니다. 프로세스를 종료하기 위해 아래 명령어를 사용합니다:

sudo kill -9 <PID>

여기서 <PID>는 종료하고자 하는 프로세스의 ID로 바꾸어 입력하면 됩니다. 위의 예시에서는 sudo kill -9 20642와 같이 입력해 처리할 수 있습니다. 이후에는 비밀번호를 입력하면 프로세스가 종료됩니다.

마무리하며

이 포스팅에서는 Spring Boot에서 ‘Port 8080 is already in use’라는 오류를 해결하는 방법에 대해 알아보았습니다. 이 방법은 다른 포트에서도 비슷하게 적용할 수 있으니, 여러분의 개발 환경에서 유용하게 활용해 보시기 바랍니다.

더욱 다양한 Spring Boot 관련 정보를 원하신다면, 댓글이나 질문으로 남겨주세요! 프로그래밍의 세계는 언제나 배우고 나누는 즐거움이 가득합니다. 다음 포스트에서 만나요!