[JPA] 하이버네이트에서 Lazy Loading 사용 시 프록시 객체의 필드가 Null인 현상

 

 

 

 

 

JPA 구현체로 하이버네이트를 쓰신다면 주의해야 할 점이 있습니다.

코드를 보며 살펴보겠습니다.

 

 

 

 

 

문제가 되는 상황을 간략한 코드로 나타내어 보겠습니다.

@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@Entity
@Table(name = "member")
public class Member {

	@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
	@Column(name = "member_id")
	private long id;

	@ManyToOne(fetch = FetchType.LAZY)
	@JoinColumn(name = "team_id")
	private Team team;

	public void setTeam(Team team) {
		this.team = team;
	}
}

 

 

Team은 Member를 여러개 가질 수 있습니다.

 

 

 

@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@Entity
@Table(name = "team")
public class Team {
   @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
   @Column(name = "team_id")
   private Long id;

   public String name;


   public void setName(String name) {
      this.name = name;
   }

   public void fieldLogic(){
      System.out.println(this.name);
   }

   public void methodLogic(){
      System.out.println(this.getName());
   }

}

 

 

테스트를 위해 name을 public으로 설정하였습니다.

 

 

 

 

 

 

 

문제가 되는 코드

Member member = new Member();
Team team = new Team();
team.setName("팀이름");
member.setTeam(team);
em.persist(team);
em.persist(member);
em.flush();
em.clear();


Member find = em.find(Member.class, member.getId());

System.out.println("=========필드 접근========");
System.out.println(find.getTeam().name);

 

 

위 코드를 실행하면 다음 결과가 나옵니다.

 

 

 

 

 

 

원인

https://stackoverflow.com/questions/8945365/jpa-hibernate-proxy-not-fetching-real-object-data-sets-all-properties-to-null%EF%BB%BF

 

 

하이버네이트에서는 Lazy Loading으로 설정된 연관관계를 가진 객체에 대해서는,

필드가 모두 Null로 설정된 프록시 객체를 반환한다고 합니다.

(EAGER 혹은 fetch join을 사용한 경우에는 실제 객체가 바로 반환되므로 이러한 예외가 발생하지 않습니다.)

 

 

이를 사용하기 위해서는 필드가 아닌 getter 등의 다른 public 혹은 protected 메서드를 통해 접근하여야 합니다.

(private 혹은 package-private 메서드로 접근하는 경우 여전히 초기화되지 않습니다)

 

 

 

위의 코드가 오류가 발생하지 않기 위해서는 다음과 같은 방법들을 사용해야 합니다.

 

Member find = em.find(Member.class, member.getId());

System.out.println("========필드 메서드 접근=========");
find.getTeam().fieldLogic();

 

위의 코드를 실행하면 다음과 같이 지연로딩 객체를 실제 조회하는 것을 알 수 있습니다.

 

 

 

아래 메서드들도 동일하게 작동합니다.

Member reference = em.find(Member.class, member.getId());

System.out.println("==========메서드 메서드 접근=======");
reference.getTeam().methodLogic();

Member reference = em.find(Member.class, member.getId());

System.out.println("========== 메서드 접근=======");
System.out.println(reference.getTeam().getName());

 

 

 

 

 

 

 

 

주의점

지연로딩된 객체를 실제 조회하였더라도, 해당 객체의 필드는 모두 null입니다.

 

예시 코드입니다.

Member member = new Member();
Team team = new Team();
team.setName("별명");
member.setTeam(team);
em.persist(team);
em.persist(member);
em.flush();
em.clear();


Member find = em.find(Member.class, member.getId());

System.out.println("========필드 메서드 접근=========");
find.getTeam().fieldLogic();

System.out.println(find.getTeam().name);

 

다음 코드를 실행하면 다음과 같은 결과가 발생합니다.

 

 

 

 

 

 

 

 

 

 

 

그러나 실제로 필드를 public으로 열어서 사용하는 일은 없기 때문에 딱히 문제될 일은 생기지 않을 것 같습니다.

 

그러나 저의 경우에는 자기 자신에 대한 @ManyToOne 관계를 설정한 클래스에서 이러한 오류가 발생했습니다

 

 

저의 코드는 다음과 같았습니다.

@Service
@RequiredArgsConstructor
@Transactional
public class CommentServiceImpl implements CommentService{

    private final CommentRepository commentRepository;



    @Override
    public void remove(Long id) throws Exception {
        Comment comment = commentRepository.findById(id).orElseThrow(() -> new Exception("댓글이 없습니다."));

        List<Comment> removableCommentList = comment.findRemovableList();//여기부분!!!!!
        
        removableCommentList.forEach(removableComment -> commentRepository.delete(removableComment));
    }
}

 

List<Comment> removableCommentList = comment.findRemovableList();

해당 메서드에서 오류가 발생했습니다.

 

 

해당 메서드는 다음과 같이 구현되어 있습니다.

public class Comment extends BaseTimeEntity {
    
    ...
    private String content;


    @ManyToOne(fetch = LAZY)
    @JoinColumn(name = "parent_id")
    private Comment parent;
    

    public List<Comment> findRemovableList() {
    	Optional<Comment> parent = Optional.ofNullable(this.parent);
    	List<Comment> result = new ArrayList<>();
    
    	parent.ifPresentOrElse(
            parentComment ->{  
                if( parentComment.isRemove()){//이부분 오류 발생
                   //로직
            }},
            () -> {}
    	);

    	return result;
    }

    private boolean isRemove() {
    	return content.equals(REMOVE_MESSAGE);
    }
}

isRemove의 메소드에서  content is null이라는 오류가 발생했습니다.

 

분명 content는 null이 아니었음에도 불구하고, 디버깅을 해보았는데 값이 들어가지 않았습니다.

이도 역시 content 대신 getContent()를 사용하면 해결됩니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

값을 바꾸는 경우

Member 클래스에 다음 메서드를 추가하였습니다.

public void changeTeamName() {
   System.out.println("팀 이름 변경합니당");
   this.team.name = "팀 이름 변겅";
}

 

그리고 다음 테스트코드를 실행하면

Member member = new Member();
Team team = new Team();
team.setName("팀이름");
member.setTeam(team);
em.persist(team);
em.persist(member);
em.flush();
em.clear();

Member find = em.find(Member.class, member.getId());

find.changeTeamName();
em.flush();
em.clear();

find = em.find(Member.class, member.getId());
System.out.println(find.getTeam().getName());

 

변경되지 않은 것을 알 수 있습니다.

 

 

 

그러나 내부에서 접근하면 이는 달라집니다.

 

 

 

 

 

Member에 다음 메서드를 추가합니다.

public void changeTeamNameByMethod() {
   this.team.changeName();
}

 

Team에는 다음 메서드를 추가합니다.

public void changeName() {
   this.name= "바꾼다아앙";
}

 

 

다음 코드를 실행합니다.

Member member = new Member();
Team team = new Team();
team.setName("팀이름");
member.setTeam(team);
em.persist(team);
em.persist(member);
em.flush();
em.clear();

Member find = em.find(Member.class, member.getId());

find.changeTeamNameByMethod();
em.flush();
em.clear();

find = em.find(Member.class, member.getId());
System.out.println(find.getTeam().getName());

 

성공하는 것을 확인할 수 있습니다.

 

 

 

 

 

 

 

 

 

 

그렇다면 셀프 참조는 어떨까요?

 

셀프 계층구조 값 변경의 경우

@Getter
@NoArgsConstructor(access = AccessLevel.PUBLIC)
@Entity
@Table(name = "member")
public class Member {

   @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
   @Column(name = "member_id")
   private long id;

   @ManyToOne(fetch = FetchType.LAZY)
   @JoinColumn(name = "parent_id")
   private Member parent;

   private String name;

   public void setName(String name) {
      this.name = name;
   }

   public void setId(long id) {
      this.id = id;
   }

   public void setParent(Member parent) {
      this.parent = parent;
   }

   public void changeParentNameV1(){
      this.parent.name = "부모 이름 변경V1";
   }

   public void changeParentNameV2(){
      getParent().name = "부모 이름 변경V2";
   }
   public void changeParentNameV3(){
      this.parent.setName("부모 이름 변경 V3");
   }
}

 

 

 

 

 

 

 

 

Member child = new Member();
Member parent = new Member();
parent.setName("기존");
child.setParent(parent);
em.persist(child);
em.persist(parent);
em.flush();
em.clear();





Member find = em.find(Member.class, child.getId());
find.changeParentNameV1();
em.flush();
em.clear();




find = em.find(Member.class, child.getId());
System.out.println(find.getParent().getName());

결론은 바뀌지 않습니다.

 

 

 

V2 역시 동일합니다.

 

 

 

 

 

 

 

그러나 V3의 경우 달라진 것을 알 수 있습니다.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

비슷한 문제 

이와 비슷한 문제로, 스프링 빈과 프록시 관련된 문제입니다.

 

https://kim-jong-hyun.tistory.com/110

[Spring] - Spring에서 Proxy 타입으로 생성된 Bean을 사용할 때 주의점 (feat. @Repository)

 

요약하자면 Target Class를 Proxy로 래핑한 Bean이 있을 때, 해당 프록시는 메서드에 대해서만 작동하고 필드에 대해서는 적용을 하지 않는다는 것입니다.