Spring Boot 트러블슈팅(org.springframework.context.ApplicationContextException: Unable to start web server)

Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Unable to start web server; nested exception is java.lang.IllegalStateException: Unable to create the directory [/tmp/tomcat.*] to use as the base directory

개발 서버 배포 문제 해결 과정

개발 서버를 배포하는 과정에서, 배포가 완료되지 않고 애플리케이션이 계속해서 실행 종료를 반복하는 현상이 발생했다.

처음에는 소스 코드 수정 과정에서 발생한 문제일 가능성을 의심하여, 코드를 이전 버전으로 롤백하고 다시 배포를 진행했으나, 상황은 여전했다.

에러 로그를 확인하던 중, Unable to create the directory라는 메시지가 나타나는 것을 발견했다.

이를 보고 해당 디렉토리를 수동으로 생성하면 해결될까 시도해 보았으나, 실행 시점마다 파일명이 계속 변경되어 효과가 없었다.

구글 검색을 통해 해결책을 찾던 중, GPT에게 도움을 요청하기로 했다. GPT는 다음과 같이 답변했다:

오류 메시지에서 임베디드 Tomcat이 임시 디렉토리 /tmp/tomcat.*를 생성하지 못했다는 점이 확인됩니다. 
이전 메시지에서도 디스크 공간 부족과 관련된 문제가 있었으므로, 이 문제는 디스크 공간 부족이 지속적으로 영향을 미치고 있는 것으로 보입니다.

GPT의 답변에 따라 디스크 용량을 확인해 보니, 실제로 디스크가 100%로 가득 차 있는 상태였다.

이에 불필요한 파일들을 정리한 뒤 서버를 재시작하니 정상적으로 동작했다.

 

추가적으로, 서버가 정상적으로 작동하는 상황에서도 일부 API가 호출되지 않는 문제가 있었다.

이 문제 역시 디스크 용량 부족으로 인해 발생한 것으로 확인되었다.

불필요한 파일을 정리한 후 해당 문제도 해결되었다.