[Axon] jakarta.persistence.PersistenceException

Java Persistence API(JPA)를 사용하여 ORM(Object-Relational Mapping)을 구현하는 과정에서 발생하는 여러가지 문제점 중 하나인 jakarta.persistence.PersistenceException: No default constructor for entity 오류에 대해 알아보겠습니다.

Axon 프로젝트를 실행하고 테스트하는 과정에서 이러한 오류가 발생했는데, 흔히 JPA와 관련된 프로젝트에서 만나게 되는 오류 중 하나입니다. 이 오류의 원인과 해결 방법에 대해 알아보고, 이를 통해 JPA와 기본 생성자의 중요성에 대해 이해하는 시간을 갖도록 하겠습니다.

1. PersistenceException 오류 원인 분석: 기본 생성자가 없다?

첫번째로, 에러 메시지를 살펴보겠습니다.

jakarta.persistence.PersistenceException: Converting 
`org.hibernate.InstantiationException` to JPA 
`PersistenceException` : No default constructor for entity:  : 
com.example.axon.projection.Post

위 메시지를 분석해보면, org.hibernate.InstantiationException이 JPA PersistenceException으로 변환되었고, 이유는 com.example.axon.projection.Post 엔티티에 기본 생성자가 없기 때문이라는 것을 알 수 있습니다.

기본 생성자는 매개 변수가 없는 생성자를 말합니다. 즉, new SomeClass()와 같은 방식으로 호출할 수 있는 생성자입니다. JPA는 데이터베이스에서 데이터를 가져올 때 이런 형태의 기본 생성자를 사용하여 객체를 인스턴스화합니다.

따라서, 만약 엔티티 클래스에 기본 생성자가 없다면, JPA는 엔티티 객체를 생성할 수 없어 No default constructor for entity라는 오류를 발생시킵니다.

2. 필요한 개념: JPA와 기본 생성자

JPA는 Java의 ORM 표준이며, 객체와 관계형 데이터베이스의 데이터를 자동으로 매핑해주는 기술입니다. 하지만 이러한 매핑을 수행하려면 JPA가 엔티티 객체를 생성하고 관리할 수 있어야 합니다.

이때 중요한 것이 바로 기본 생성자입니다. JPA는 엔티티 객체를 생성할 때 반드시 기본 생성자를 호출합니다. 이는 JPA의 동작 원리 중 하나인 '투명한 지속성' 때문인데, 이는 JPA가 개발자의 도메인 모델을 가능한 한 수정하지 않고, 원래의 모습 그대로 사용하려는 원칙입니다.

따라서 JPA는 엔티티 클래스에 기본 생성자를 명시적으로 요구합니다. 만약 기본 생성자가 없다면, JPA는 엔티티 객체를 생성하지 못하고 위와 같은 오류를 발생시킵니다.

3. 오류 해결: 기본 생성자 추가하기

위에서 언급한 바와 같이, 이 오류는 엔티티 클래스에 기본 생성자를 추가함으로써 해결할 수 있습니다. 이때 기본 생성자는 public 또는 protected로 선언되어야 합니다.

Post 클래스에 기본 생성자를 추가해보겠습니다.

public class Post {
    // Your existing fields and methods

    // Add a default constructor
    public Post() {
    }
}

기본 생성자를 추가한 후에는 JPA가 Post 객체를 정상적으로 생성할 수 있습니다. 따라서 애플리케이션을 다시 실행하면 No default constructor for entity 오류가 사라졌을 것입니다.

결론

JPA를 사용하는 과정에서 No default constructor for entity 오류는 꽤 자주 발생하는 문제입니다. 이 오류는 엔티티 클래스에 기본 생성자가 없을 때 발생하며, 이를 해결하는 방법은 간단하게 기본 생성자를 추가하는 것입니다.

이를 통해 JPA가 엔티티 객체를 생성하고 관리하는 방법에 대해 이해하고, 이와 관련된 오류를 해결하는 방법에 대해 배웠습니다. 이를 기억하면서 JPA와 관련된 프로젝트를 진행하면, 이러한 종류의 오류를 더 빨리 해결할 수 있을 것입니다.