“Unable to start embedded Tomcat”은 스프링 부트(Spring Boot) 어플리케이션을 실행할 때 발생하는 일반적인 에러 중 하나입니다. 이 에러는 내장 Tomcat 서버가 제대로 시작하지 못했음을 나타냅니다. 이 문제를 해결하기 위해서는 우선 에러 원인을 찾아야 합니다.
1. 에러 로그 확인하기
에러 발생 시 스프링 부트는 에러 로그를 콘솔에 출력합니다. 에러 로그를 자세히 살펴보면 “Unable to start embedded Tomcat” 에러의 원인을 찾는 데 도움이 됩니다. 일반적으로, 에러 메시지는 “Caused by:” 라는 구문 뒤에 표시됩니다. 이 메시지를 통해 문제가 발생한 구체적인 위치와 원인을 알 수 있습니다.
2. 포트 충돌 확인하기
가장 흔한 원인 중 하나는 이미 사용 중인 포트에 어플리케이션이 바인딩하려고 시도하였을 때 발생합니다. 이 경우, 다른 프로세스가 이미 사용 중인 포트를 해제하거나, 어플리케이션의 포트를 변경해야 합니다.
포트를 확인하는 방법은 운영체제에 따라 다릅니다. Linux와 MacOS에서는 lsof -i :포트번호를 사용하여 해당 포트를 사용하는 프로세스를 찾을 수 있습니다. Windows에서는 netstat -ano | findstr :포트번호를 사용하여 동일한 작업을 수행할 수 있습니다.
3. 프로젝트 설정 확인하기
다른 원인으로는 프로젝트 설정에 문제가 있을 수 있습니다. 예를 들어, application.properties 또는 application.yml 파일에서 잘못된 설정을 지정했을 수 있습니다.
또한, 스프링 부트 버전과 Tomcat 버전 간의 충돌도 이런 문제를 일으킬 수 있습니다. 이 경우에는 라이브러리 의존성을 확인하고 필요한 경우 업데이트하거나 다운그레이드해야 합니다.
4. 소스 코드 검사하기
코드의 문제로 인해 이 에러가 발생할 수도 있습니다. 예를 들어, 웹 컨트롤러나 서비스 클래스에서 발생하는 런타임 에러는 Tomcat이 정상적으로 시작되지 못하게 만들 수 있습니다. 이 경우에는 소스 코드를 자세히 살펴보고 이상이 있는지 확인해야 합니다.
5. 해결
5.1 포트 충돌 해결하기
이미 사용 중인 포트를 해제하거나 어플리케이션의 포트를 변경하여 문제를 해결할 수 있습니다.
포트를 해제하는 방법은 운영 체제에 따라 다릅니다. Linux나 MacOS에서는 kill 명령을 사용해 프로세스를 종료할 수 있습니다. 예를 들어, 8080 포트를 사용하는 프로세스의 ID가 1234라면, kill -9 1234 명령으로 프로세스를 종료할 수 있습니다.
또 다른 방법으로는 어플리케이션의 포트를 변경하는 것입니다. application.properties 파일에서 server.port 속성을 수정하여 어플리케이션의 포트를 변경할 수 있습니다. 예를 들어, 어플리케이션을 8090 포트에서 실행하려면 server.port=8090으로 설정합니다.
5.2 프로젝트 설정 수정하기
프로젝트 설정에 문제가 있는 경우, 해당 설정을 수정해야 합니다. 예를 들어, 잘못된 application.properties 설정을 수정하거나 필요한 경우 라이브러리의 버전을 업데이트하거나 다운그레이드해야 할 수 있습니다.
5.3 소스 코드 수정하기
소스 코드에 문제가 있는 경우, 에러를 일으키는 코드를 수정해야 합니다. 예를 들어, 웹 컨트롤러나 서비스 클래스에서 발생하는 런타임 에러를 수정해야 할 수 있습니다.
5.4 다시 실행하기
모든 수정을 완료한 후, 어플리케이션을 다시 실행해보세요. 이제 “Unable to start embedded Tomcat” 에러가 해결되어야 합니다.
6. 마치며
“Unable to start embedded Tomcat” 에러는 다양한 원인으로 발생할 수 있으며, 이에 따라 해결 방법도 다양합니다. 위에서 설명한 방법을 통해 문제를 해결할 수 있습니다. 그러나 이외에도 다양한 원인이 있을 수 있으니, 원인을 찾아서 적절하게 대응하는 것이 중요합니다. 기억해야 할 것은 로그 메시지를 주의 깊게 읽는 것이 가장 좋은 해결 방법의 시작이라는 점입니다.
