@Transactional, 정말 잘 알고 쓰고 있나요?

@Transactional은 스프링에서 가장 많이 쓰이지만, 가장 많이 오해되는 기능 중 하나입니다. 이 글에서는 단순한 사용법을 넘어서, 실무에서 겪는 다양한 오작동 사례와 그 원인을 정리하고, 안전하게 사용하는 방법까지 친절히 설명합니다.

1. @Transactional은 무엇인가?

📌 기본 동작 흐름

java
1@Transactional
2public void serviceMethod() {
3    // 트랜잭션 시작
4    repository.save();
5    // 트랜잭션 커밋 or 롤백
6}

2. AOP와 프록시, 그리고 @Transactional의 동작 원리

🔧 예시 흐름

• UserService 클래스에 @Transactional이 붙어 있다면
• Spring은 이 클래스의 프록시(UserService$$EnhancerBySpringCGLIB)를 만들어 등록함
• 메서드 호출은 항상 이 프록시 객체를 통해 이루어짐
• 프록시는 트랜잭션을 시작하고, 메서드가 끝나면 커밋 or 롤백을 수행함

📎 중요: 프록시를 우회하면 트랜잭션이 작동하지 않습니다.
즉, 같은 클래스 내부 메서드 호출처럼 프록시를 거치지 않으면 @Transactional은 무시됩니다.

3. 프록시의 한계: 내부 호출 무시

java
1@Service
2public class MyService {
3
4    @Transactional
5    public void outer() {
6        inner(); // 트랜잭션 안 잡힘
7    }
8
9    @Transactional
10    public void inner() {
11        // 트랜잭션이 적용되지 않음
12    }
13}

💡 해결 방법

• inner() 메서드를 다른 Bean으로 분리
• 혹은 self-injection 방식으로 자기 자신을 주입받아 호출

java
1@Autowired
2private MyService self;
3
4public void outer() {
5    self.inner(); // 프록시 경유 → 트랜잭션 작동
6}

4. 예외에 따른 rollback 여부

java
1@Transactional
2public void process() throws IOException {
3    throw new IOException(); // rollback 안 됨
4}

💡 해결 방법

java
1@Transactional(rollbackFor = Exception.class)

• 명시적으로 롤백할 예외 타입을 지정

5. 외부 API와 함께 쓸 때 주의사항

java
1@Transactional
2public void registerUser(User user) {
3    userRepository.save(user);
4    externalApi.sendNotification(user); // 이건 롤백되지 않음
5    throw new RuntimeException();
6}

💡 해결 방법

• 외부 호출은 트랜잭션 외부로 분리 (이벤트 기반 설계 또는 Outbox Pattern 사용)

6. 전파 속성(Propagation) 제대로 쓰기

java
1@Transactional(propagation = Propagation.REQUIRES_NEW)
2public void writeLog() {
3    logRepository.save(...);
4}

7. flush 타이밍도 기억하자 (JPA)

java
1userRepository.save(user);
2externalService.call(); // 여기서 예외 발생 시 DB엔 아직 반영되지 않음

🧭 마무리하며