서론

Java Spring Boot 애플리케이션을 EC2에 배포 시,
Thymeleaf를 사용하여 HTML 템플릿을 렌더링하는 중에
발생했던 오류에 대해 알아보겠습니다.

본론

오류 메시지는 "org.thymeleaf.TemplateEngine"에 관한 것이었습니다.
이 오류는 Thymeleaf 템플릿 엔진에서 발생하는 문제로,
주로 다음과 같은 이유로 발생합니다.

• 템플릿 파일 경로가 잘못된 경우
• Thymeleaf 구성이 올바르게 설정되지 않은 경우
• Gradle 또는 Maven과 같은 빌드 도구를 사용하여 프로젝트를 빌드하지 않은 경우
• 클래스 경로에서 필요한 파일이나 라이브러리가 누락된 경우

저와 같은 경우, 로컬 PC에서 Spring Boot를 수정하고
제대로 실행 됨을 확인한 후 Git에 push 하고,
EC2에서 pull한 후, 애플리케이션을 시작하는 경우라서 찾기가 어려웠습니다.

그런데 알고보니..

templates/userPages 폴더 내에 있는 registerForm을 반환하는 과정에서

경로를 '/'로 시작해서 발생했던 오류였습니다.

이렇게 작성할 경우 로컬 PC에서는 제대로 실행 되었지만

EC2 인스턴스에서는 에러가 발생했습니다.

그래서 다음과 같이 경로 앞에 '/'를 삭제해주었더니
에러가 발생하지 않았습니다.

결론

Thymeleaf에서 발생하는 "org.thymeleaf.TemplateEngine" 오류는
다양한 원인으로 인해 발생할 수 있습니다.
이러한 오류를 해결하기 위해서는 템플릿 파일 경로를 확인하고
Thymeleaf 구성을 확인하는 것이 중요합니다.
또한, 프로젝트를 빌드하고 클래스 경로를 확인하여
필요한 파일이나 라이브러리가 사용 가능한 상태인지 확인해야 합니다.