🚨 [Spring JPA] 로컬은 되는데 배포에서만 LazyInitializationException이 뜬다?

로컬에선 잘 되던 코드가 배포 환경에서만 터지는 LazyInitializationException 원인과 해결 과정을 정리해보았습니다.

---

에러 상황

사용자 검색 페이지에서 아래와 같은 예외가 발생했습니다.

failed to lazily initialize a collection of role: innocean.domain.auth.User.userRoles: could not initialize proxy - no Session
org.hibernate.LazyInitializationException

---

문제 코드

컨트롤러 (유저 검색 API)

@GetMapping("/search")
@PreAuthorize("hasAuthority('ADMIN_MANAGE')")
public String searchUsers(Model model, @RequestParam(required = false) String query, ...) {
    Pageable pageable = PageRequest.of(page, size, sort);
    List<String> queries = parseQueryList(query);

    Page<UserWithRolesDTO> pagedUsers = userRoleService.searchUsers(queries, enabled, roleIds, pageable);

    model.addAttribute("users", pagedUsers);
    return "admin/user";
}

여기서 제 코드는 User -> Userrole -> Role 이렇게 차례차례 이동하며 user의 role 정보를 찾습니다. (다:다 관계)

서비스

public Page<UserWithRolesDTO> searchUsers(List<String> queries, Boolean enabled, List<Long> roleIds, Pageable pageable) {
    Specification<User> spec = Specification
            .where(UserSpecifications.containsNameOrEmail(queries))
            .and(UserSpecifications.hasEnabled(enabled))
            .and(UserSpecifications.hasRoles(roleIds));

    return userRepository.findAll(spec, pageable)
            .map(UserWithRolesDTO::from);  // ❗ Lazy 객체 접근 시도
}

DTO 변환 코드

public static UserWithRolesDTO from(User user) {
    List<String> roleNames = user.getUserRoles().stream()
            .filter(UserRole::isEnabled)
            .map(ur -> ur.getRole().getName())  // ❗ Lazy 로딩 발생 지점
            .toList();

    return new UserWithRolesDTO(
            user.getId(),
            user.getUsername(),
            user.getEmail(),
            user.isEnabled(),
            roleNames,
            user.getCreatedAt()
    );
}

---

왜 로컬에선 안 터짐...?

로컬에서는 트랜잭션이 살아 있는 상태에서 DTO가 생성돼서 Lazy 로딩이 가능하지만,
배포 환경에서는 트랜잭션이 먼저 종료된 뒤 DTO를 생성하게 되어 Hibernate 세션이 닫혀버립니다. (배포 시에는 트랜잭션 유지 기간이 더 짧아집니다 ㅜ.ㅜ)

결과적으로 JPA Lazy 객체를 트랜잭션 밖에서 접근하면서 예외 발생!

---

해결 방법 : @EntityGraph 사용

Spring Data JPA의 @EntityGraph를 활용하면 필요한 필드를 미리 fetch join해서 로딩할 수 있습니다.

---

UserRepository 수정

여기서 userRole과 role 정보를 미리 받아오는 거죠!

import org.springframework.data.jpa.repository.EntityGraph;

@EntityGraph(attributePaths = {"userRoles", "userRoles.role"})
Page<User> findAll(Specification<User> spec, Pageable pageable);

이후에는 DTO에서 Lazy 필드 접근해도 문제 없이 작동합니다.

user.getUserRoles().stream()
    .map(ur -> ur.getRole().getName())  // 💡 이제 안전하게 접근 가능

---

UserWithrolesDTO.java (참고용)

public record UserWithRolesDTO(
        Long id,
        String username,
        String email,
        boolean enabled,
        List<String> roles,
        LocalDateTime createdAt
) {
    public static UserWithRolesDTO from(User user) {
        List<String> roleNames = user.getUserRoles().stream()
                .filter(UserRole::isEnabled)
                .map(ur -> ur.getRole().getName())
                .toList();

        return new UserWithRolesDTO(
                user.getId(),
                user.getUsername(),
                user.getEmail(),
                user.isEnabled(),
                roleNames,
                user.getCreatedAt()
        );
    }
}

---

마무리

✨ Lazy 필드를 View에서 사용할 땐 반드시 fetch join이나 @EntityGraph로 미리 로딩하길.
안 그러면 로컬에선 되고, 배포에선 안 되는 의문의 버그를 만나게 됩니다 ^_^
저도 알고 싶지 않았어요