Trouble Shooting - 스프링 에러 로그 읽는 법과 Not a managed type 문제

유저 생성 기능을 추가한 뒤 서버 실행 중 아래와 같은 에러가 발생했다.

Error starting ApplicationContext
Application run failed
...
Not a managed type: class com.schedule2.entity.User

처음에는 맨 위의 Application run failed 만 보고 원인을 찾으려고 했는데,
이 문장은 단순히 “애플리케이션 실행이 실패했다” 는 요약일 뿐이었다.

실제 원인은 에러 로그를 아래로 내려가며 확인한 Caused by 부분에 있었다.

에러 흐름은 다음과 같았다.

• UserController 생성 실패
• UserService 생성 실패
• UserRepository 생성 실패
• 최종 원인: Not a managed type: class com.schedule2.entity.User

즉, JPA가 User 클래스를 엔티티로 관리되는 타입으로 인식하지 못해서
UserRepository를 생성할 수 없었고, 그 결과로 서비스와 컨트롤러도 연쇄적으로 생성되지 못한 것이었다.

원인

User 엔티티가 JPA 엔티티로 제대로 등록되지 않은 상태였다.

해결 방법

User 클래스에 엔티티 관련 설정이 제대로 들어가 있는지 확인했다.

@Entity
@Table(name = "users")
public class User extends BaseEntity {

그리고 저장/빌드 상태까지 다시 확인한 뒤 서버를 재실행하니 문제가 해결되었다.

이번에 배운 점

스프링 에러 로그를 볼 때는 맨 위 요약 문장만 보면 안 되고,
반드시 아래쪽의 Caused by 와 가장 마지막의 구체적인 에러 문장을 확인해야 한다.

즉,

• 위쪽: 어떤 작업이 실패했는지
• 아래쪽: 왜 실패했는지

이 순서로 읽는 습관이 중요하다.