본문 바로가기
Q&A해결2026년 4월 27일1분 읽기

Spring Boot 5 RC에서 @Transactional(readOnly=true)의 동작이 변경됐다는데?

J
Java개발
조회 616댓글 1

Spring Boot 4 → 5 RC로 마이그레이션 중인데, @Transactional(readOnly=true)를 붙인 메서드 안에서 entity 변경 후 자동 dirty checking이 안 일어나는 케이스가 발생합니다.

4까지는 readOnly=true라도 entity가 managed 상태면 변경이 반영되곤 했는데, 5에서는 무시되는 듯합니다. release notes를 봐도 명확한 변경점을 못 찾겠네요. 어떻게 된 건가요?

댓글 1

김김영삼6개월 전

Spring Boot 5의 의도된 변경입니다. 4까지는 readOnly=true가 사실상 "힌트"로 동작해서 dirty checking이 그대로 작동했지만, 5에서는 "진짜 readOnly"로 강화됐습니다.

변경의 본질

버전readOnly=true 동작Spring Boot 4 (Spring Framework 6.x)JDBC connection만 readOnly로 설정. JPA flush는 동작Spring Boot 5 (Spring Framework 7.x)+ Hibernate FlushMode.MANUAL 자동 적용. dirty checking 무시

왜 바뀌었나

4 시절의 동작이 의도와 어긋난다는 비판이 누적됐습니다. readOnly=true를 붙인 의도는 "이 메서드는 쓰기 안 함"인데, 실제로는 무심코 entity 변경이 DB에 반영되어 데이터가 변경되는 사고가 잦았습니다.

5는 readOnly의 의미를 "flush 자체가 일어나지 않음"으로 강화. 이름값에 충실해진 셈입니다.

새 동작 검증

@Transactional(readOnly = true)
public void example(Long userId) {
User user = userRepository.findById(userId).orElseThrow();
user.setName("changed"); // managed entity 수정
// 4: flush 시 UPDATE 발행 (의도치 않은 변경)
// 5: flush 자체가 발생 안 함 → DB 변경 없음
}

원하는 의미가 4의 동작이라면 readOnly 자체를 빼야 합니다.

마이그레이션 패턴

1) 진짜 readOnly 메서드 — 그대로 둔다 (5의 동작이 더 안전)

@Transactional(readOnly = true)
public List<UserDTO> findAll() {
return userRepository.findAll().stream()
.map(UserMapper::toDto)
.toList();
// 어차피 변경 안 함 — readOnly 의도 정확
}

2) "주로 읽기지만 일부 쓰기"가 섞인 메서드 — readOnly 제거

// Before
@Transactional(readOnly = true)
public User loginAndUpdateLastSeen(String email) {
User u = userRepository.findByEmail(email);
u.setLastSeen(Instant.now()); // 5에서는 반영 안 됨
return u;
}

// After — readOnly 제거 또는 두 단계로 분리
@Transactional
public User loginAndUpdateLastSeen(String email) { ... }

또는 명확하게 분리:

@Transactional(readOnly = true)
public User findByEmail(String email) { ... }

@Transactional
public void updateLastSeen(Long id) {
User u = userRepository.findById(id).get();
u.setLastSeen(Instant.now());
}

흔한 함정 — service 호출 사슬

// outerMethod가 readOnly=true → innerMethod도 그 트랜잭션 안에서 실행
@Transactional(readOnly = true)
public void outerMethod() {
innerService.innerMethod(); // 새 트랜잭션 안 만듦
}

// innerMethod가 entity 변경하려 해도 실패
@Transactional // PROPAGATION_REQUIRED — 외부 readOnly 트랜잭션 join
public void innerMethod() {
user.setName("..."); // 5에서 반영 안 됨
}

해결 — 명시적 PROPAGATION_REQUIRES_NEW:

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void innerMethod() { ... }
// 새 트랜잭션을 강제 → outer의 readOnly 영향 안 받음

Hibernate의 FlushMode 직접 제어

// 4의 동작 그대로 가져가고 싶다면
@Transactional(readOnly = true)
public void example() {
entityManager.unwrap(Session.class)
.setHibernateFlushMode(FlushMode.AUTO);

User u = userRepository.findById(1L).get();
u.setName("changed");
// 강제 flush
entityManager.flush();
}

가능은 하지만 권장 안 합니다 — readOnly의 의미를 무력화하는 것이라 코드 의도가 모호해집니다.

성능 측면 — readOnly의 진짜 가치

5의 변경 덕분에 readOnly=true가 진짜 최적화로 동작합니다.

  • FlushMode.MANUAL → 자동 dirty check 비용 0
  • JDBC connection readOnly hint → DB 측 일부 최적화
  • 일부 ORM이 read-only mode에서 1차 캐시 단순화

실측: read-heavy 워크로드에서 평균 응답시간 8~15% 개선 사례.

마이그레이션 체크리스트

  1. 코드베이스 전체에서 @Transactional(readOnly = true) 검색
  2. 해당 메서드 안에 setter·persist·remove·createQuery(UPDATE/DELETE)가 있는지 점검
  3. 있으면 → readOnly 제거 또는 메서드 분리
  4. 없으면 → 그대로 (안전)
  5. 통합 테스트로 실제 DB 변경 여부 검증 — 4에서 우연히 동작하던 케이스를 잡아냄

마지막 한 줄

5의 변경은 사실 "원래 의도대로 만든 것"입니다. 4에서 readOnly=true 안에서 변경이 일어나던 코드는 거의 다 버그였습니다. 마이그레이션 과정에서 발견되는 "안 되는 코드"는 사실 5 덕분에 드러난 잠재 버그라 생각하시는 게 맞습니다.

Ctrl+Enter로 등록