# 스프링 트랜잭션 전파2 - 활용

## 1. 트랜잭션 전파 활용1 - 예제 프로젝트 시작&#x20;

#### 비즈니스 요구사항&#x20;

* 회원을 등록하고 조회한다.&#x20;
* 회원에 대한 변경 이력을 추적할 수 있도록 회원 데이터가 변경될 때 변경 이력을 DB LOG 테이블에 남겨야 한다.&#x20;
  * 여기서는 예제를 단순화 하기 위해 회원 등록시에만 DB LOG 테이블에 남긴다.&#x20;

#### Member&#x20;

```java
package hello.springtx.propagration;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.Setter;

@Entity
@Getter @Setter
public class Member {

    @Id
    @GeneratedValue
    private Long id;
    private String username;

    public Member() {
    }

    public Member(String username) {
        this.username = username;
    }
}
```

#### **MemberRepository**

```java
package hello.springtx.propagration;

import jakarta.persistence.EntityManager;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Repository;
import org.springframework.transaction.annotation.Transactional;

import java.util.Optional;

@Slf4j
@Repository
@RequiredArgsConstructor
public class MemberRepository {

    private final EntityManager em;

    @Transactional
    public void save(Member member) {
        log.info("member save");
        em.persist(member);

    }

    public Optional<Member> find(String username) {
        return em.createQuery("select m from Member m where m.username = :username", Member.class)
                .setParameter("username", username)
                .getResultList()
                .stream()
                .findAny();
    }
}
```

#### Log

```java
package hello.springtx.propagration;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.Setter;

@Entity
@Getter @Setter
public class Log {

    @Id @GeneratedValue
    private Long id;
    private String message;

    public Log() {
    }

    public Log(String message) {
        this.message = message;
    }
}
```

#### LogRepository

```java
package hello.springtx.propagration;

import jakarta.persistence.EntityManager;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Repository;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;

import java.util.Optional;

@Slf4j
@Repository
@RequiredArgsConstructor
public class LogRepository {

    private final EntityManager em;

    @Transactional
    public void save(Log logMessage) {
        log.info("log save");
        em.persist(logMessage);

        if (logMessage.getMessage().contains("로그예외")) {
            log.info("log save 예외 발생");
            throw new RuntimeException("예외 발생");
        }
    }

    public Optional<Log> find(String message) {
        return em.createQuery("select l from Log l where l.message = :message", Log.class)
                .setParameter("message", message)
                .getResultList()
                .stream()
                .findAny();
    }
}
```

#### MemberService

```java
package hello.springtx.propagration;

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Slf4j
@Service
@RequiredArgsConstructor
public class MemberService {

    private final MemberRepository memberRepository;
    private final LogRepository logRepository;

    public void joinV1(String username) {
        Member member = new Member(username);
        Log logMessage = new Log(username);

        log.info("== memberRepository 호출 시작 ==");
        memberRepository.save(member);
        log.info("== memberRepository 호출 종료 ==");

        log.info("== logRepository 호출 시작 ==");
        logRepository.save(logMessage);
        log.info("== logRepository 호출 종료 ==");
    }

    public void joinV2(String username) {
        Member member = new Member(username);
        Log logMessage = new Log(username);

        log.info("== memberRepository 호출 시작 ==");
        memberRepository.save(member);
        log.info("== memberRepository 호출 종료 ==");

        log.info("== logRepository 호출 시작 ==");
        try {
            logRepository.save(logMessage);
        } catch (RuntimeException e) {
            log.info("log 저장에 실패했습니다. 로그 메시지: {}", logMessage.getMessage());
            log.info("정상 흐름 반환");
        }

        log.info("== logRepository 호출 종료 ==");
    }
}
```

* 회원을 등록하면서 동시에 회원 등록에 대한 DB 로그도 함께 남긴다.&#x20;
* `joinV1()`&#x20;
  * 회원과 DB 로그를 함께 남기는 비지니스 로직이다.&#x20;
  * 현재 별도의 트랜잭션을 설정하지 않는다.&#x20;
* `joinV2()`
  * `joinV1()` 과 같은 기능을 수행한다.
  * DB로그 저장시 예외가 발생하면 예외를 복구한다.
  * 현재 별도의 트랜잭션은 설정하지 않는다.

#### MemberServiceTest

```javascript
package hello.springtx.propagation;

import hello.springtx.propagration.LogRepository;
import hello.springtx.propagration.MemberRepository;
import hello.springtx.propagration.MemberService;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.transaction.UnexpectedRollbackException;

import static org.assertj.core.api.Assertions.*;
import static org.junit.jupiter.api.Assertions.*;

@Slf4j
@SpringBootTest
class MemberServiceTest {

    @Autowired
    MemberService memberService;
    @Autowired
    MemberRepository memberRepository;
    @Autowired
    LogRepository logRepository;

    /**
     * memberService    @Transactional:OFF
     * memberRepository @Transactional:ON
     * logRepository    @Transactional:ON
     */
    @Test
    void outerTxOff_success() {

        // given
        String username = "outerTxOff_success";

        // when
        memberService.joinV1(username);

        // then : 모든 데이터가 정상 저장된다.
        assertTrue(memberRepository.find(username).isPresent());
        assertTrue(logRepository.find(username).isPresent());

    }

}
```

## 2. 트랜잭션 전파 활용2 - 커밋, 롤백&#x20;

### 서비스 계층에 트랜잭션이 없을 때 - 커밋

예제ㄹ 통해 서비스 계층에 트랜잭션이 없을 때 트랜잭션이 각각 어떻게 작동하는지 확인해보자.&#x20;

#### 상황&#x20;

* 서비스 계층에 트랜잭션이 없다.&#x20;
* 회원, 로그 리포지토리가 각각 트랜잭션을 가지고 있다.&#x20;
* 회원, 로그 리포지토리 둘다 커밋에 성공한다.&#x20;

#### outerTxOff\_success

```java
/**
 * memberService    @Transactional:OFF
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON
 */
@Test
void outerTxOff_success() {

    // given
    String username = "outerTxOff_success";

    // when
    memberService.joinV1(username);

    // then : 모든 데이터가 정상 저장된다.
    assertTrue(memberRepository.find(username).isPresent());
    assertTrue(logRepository.find(username).isPresent());

}
```

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FtZEIe0vQIDUntqZ63u6g%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2007.57.26.png?alt=media&#x26;token=90481787-58f0-4e1c-9277-58e825e79c07" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FqNQdxzMAacP6OOqmpcjK%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2007.57.34.png?alt=media&#x26;token=edfd2efc-5abe-426a-8856-c48b5f5505e0" alt=""><figcaption></figcaption></figure>

1. `MemberService` 에서 `MemberRepository` 를 호출한다. `MemberRepository` 에는`@Transactional` \
   애노테이션이 있으므로 트랜잭션 AOP가 작동한다. 여기서 트랜잭션 매니저를 통해 트랜잭션을 시작한다. 이렇게 시작한 트랜잭션을 트랜잭션B라 하자.
   1. 그림에서는 생략했지만, 트랜잭션 매니저에 트랜잭션을 요청하면 데이터소스를 통해 커넥션 `con1` 을 획득하고, 해당 커넥션을 수동 커밋 모드로 변경해서 트랜잭션을 시작한다.&#x20;
   2. 그리고 트랜잭션 동기화 매니저를 통해 트랜잭션을 시작한 커넥션을 보관한다.&#x20;
   3. 트랜잭션 매니저의 호출 결과로 `status` 를 반환한다. 여기서는 신규 트랜잭션 여부가 참이 된다.&#x20;
2. `MemberRepository` 는 JPA 를 통해 회원을 저장하는데, 이때 JPA 는 트랜잭션이 시작된 `con1` 을 사용해서 회원을 저장한다.&#x20;
3. `MemberRepository` 가 정상 응답을 반환했기 때문에 트랜잭션 AOP 는 트랜잭션 매니저에 커밋을 요청한다.&#x20;
4. 트랜잭션 매니저는 `con1` 을 통해 물리 트랜잭션을 커밋한다.&#x20;
   1. 물론 이 시점에 앞서 설명한 신규 트랜잭션 여부, `rollbackOnly` 여부를 모두 체크한다.&#x20;

이렇게 해서 `MemberRepository` 와 관련된 모든 데이터는 정상 커밋되고, 트랜잭션B는 완전히 종료된다.\
이후에 `LogRepository` 를 통해 트랜잭션C를 시작하고, 정상 커밋한다.

결과적으로 둘다 커밋되었으므로 `Member`, `Log` 모두 안전하게 저장된다.

#### **@Transactional과 REQUIRED**

* 트랜잭션 전파의 기본 값은 `REQUIRED` 이다. 따라서 다음 둘은 같다.
  * `@Transactional(propagation = Propagation.REQUIRED)`&#x20;
  * `@Transactional`&#x20;
* `REQUIRED` 는 기존 트랜잭션이 없으면 새로운 트랜잭션을 만들고, 기존 트랜잭션이 있으면 참여한다.

### 서비스 계층에 트랜잭션이 없을 때  - 롤백&#x20;

#### 상황&#x20;

* 서비스 계층에 트랜잭션이 없다.&#x20;
* 회원, 로그 리포지토리가 각각 트랜잭션을 가지고 있다.&#x20;
* 회원 리포지토리는 정상 작동하지만 로그 리포지토리에서 예외가 발생한다.&#x20;

#### outerTxOff\_fail&#x20;

```java
/**
 * memberService    @Transactional:OFF
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON EXCEPTION
 */
@Test
void outerTxOff_fail() {

    // given
    String username = "로그예외_outerTxOff_fail";

    // when
    assertThatThrownBy(() -> memberService.joinV1(username))
            .isInstanceOf(RuntimeException.class);

    // then : memberRepository는 정상 저장되지만, logRepository는 예외로 인해 저장되지 않는다.
    assertTrue(memberRepository.find(username).isPresent());
    assertTrue(logRepository.find(username).isEmpty());
}
```

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2Foy8MR8MyB52Te9BeYoMD%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.35.18.png?alt=media&#x26;token=a4b87b92-9da6-4564-8c6f-fb76156d29b7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FmH42d7AElQV4m5mzksJn%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.35.27.png?alt=media&#x26;token=8ee4399b-46f9-4891-973a-076616a54167" alt=""><figcaption></figcaption></figure>

* `MemberService` 에서 `MemberRepository` 를 호출하는 부분은 앞서 설명한 내용과 같다. 트랜잭션이 정상 커밋되고, 회원 데이터도 DB 에 정상 반영된다.&#x20;
* `MemberService` 에서 `LogRepository` 를 호출하는데, 로그 예외라는 이름을 전달한다. 이 과정에서 새로운 트랜잭션 C 가 만들어진다.&#x20;

#### LogRepository 응답 로직&#x20;

1. `LogRepository` 는 트랜잭션C와 관련된 `con2` 를 사용한다.
2. `로그예외` 라는 이름을 전달해서 `LogRepository` 에 런타임 예외가 발생한다.
3. `LogRepository` 는 해당 예외를 밖으로 던진다. 이 경우 트랜잭션 AOP가 예외를 받게된다.
4. 런타임 예외가 발생해서 트랜잭션 AOP는 트랜잭션 매니저에 롤백을 호출한다.
5. 트랜잭션 매니저는 신규 트랜잭션이므로 물리 롤백을 호출한다.

## 3. 트랜잭션 전파 활용3 - 단일 트랜잭션&#x20;

### 트랜잭션 하나만 사용하기&#x20;

회원 리포지토리와 로그 리포지토리를 하나의 트랜잭션으로 묶는 가장 간단한 방법은 이 둘을 호출하는 회원 서비스에만 트랜잭션을 사용하는 것이다.&#x20;

#### singleTx&#x20;

```java
/**
 * memberService    @Transactional:ON
 * memberRepository @Transactional:OFF
 * logRepository    @Transactional:OFF
 */
@Test
void singleTx() {

    // given
    String username = "singleTx";

    // when
    memberService.joinV1(username);

    // then : 모든 데이터가 정상 저장된다.
    assertTrue(memberRepository.find(username).isPresent());
    assertTrue(logRepository.find(username).isPresent());

}
```

**MemberService - joinV1()**

```java
@Transactional //추가
public void joinV1(String username)
```

#### MemberRepository - save()&#x20;

```java
//@Transactional //제거
public void save(Member member)
```

#### LogRepository - save()&#x20;

```java
//@Transactional //제거
public void save(Log logMessage)
```

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FjxRUbL9ibSaJ4ANfEOc9%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.44.30.png?alt=media&#x26;token=65c41866-71ed-48ec-92da-3b5ef140de2f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FB9kJPjX27G9ejkd5oOng%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.46.45.png?alt=media&#x26;token=a3a2fef8-c86e-4596-b4f9-bd7e42d75e7f" alt=""><figcaption></figcaption></figure>

* 이렇게 하면 `MemberService` 를 시작할 때 부터 종료할 때 까지의 모든 로직을 하나의 트랜잭션으로 묶을 수 있다.&#x20;
  * 물론 `MemberService` 가 `MemberRepository`, `LogRepository` 를 호출하므로 이 로직들은 같은 트랜잭션을 사용한다.&#x20;
* `MemberService` 만 트랜잭션을 처리하기 때문에 앞서 배운 논리 트랜잭션, 물리 트랜잭션, 외부 트랜잭션, 내부 트랜잭션, `rollbackOnly`, 신규 트랜잭션 , 트랜잭션 전파 같은 것을 고민할 필요가 없다. 아주 단순하고 깔끔하게 트랜잭션을 묶을 수 있다.&#x20;

### 각각 트랜잭션이 필요한 상황&#x20;

하지만 다음과 같이 각각 트랜잭션이 필요한 경우는 어떻게 할까?

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FUcNK4ddNcRW5hapq6Asd%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.47.37.png?alt=media&#x26;token=e0a7f0fd-7592-4266-a023-ccf9a7517fe2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FRinrNML1CCWJLMZqatoh%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.47.45.png?alt=media&#x26;token=77f62869-371a-4155-ad2b-001c6fb538a3" alt=""><figcaption></figcaption></figure>

* 클라리언트 A 는 `MemberService` 부터 `MemberRepository`, `LogRepository` 를 모두 하나의 트랜잭션으로 묶고 싶다.&#x20;

* 클라이언트 B 는 `MemberRepository` 만 호출하고 여기에만 트랜잭션을 사용하고 싶다.&#x20;

* 클라이언트 C 는 `LogRepository` 만 호출하고 여기에만 트랜잭션을 사용하고 싶다.&#x20;

* 클라이언트 A만 생각하면 `MemberService` 에 트랜잭션 코드를 남기고, `MemberRepository`,

  `LogRepository` 의 트랜잭션 코드를 제거하면 앞서 배운 것 처럼 깔끔하게 하나의 트랜잭션을 적용할 수 있다.

* 하지만 이렇게 되면 클라이언트 B, C가 호출하는 `MemberRepository`, `LogRepository` 에는 트랜잭션을

  적용할 수 없다.

트랜잭션 전파 없이 이런 문제를 해결하려면 아마도 트랜잭션이 있는 메서드와 트랜잭션이 없는 메서드를 각각 만들어야 할 것이다.&#x20;

더 복잡하게 다음과 같은 상황이 발생할 수도 있다.&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FuFG3jpMPXzCefqsPe1n3%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.50.32.png?alt=media&#x26;token=01e54b1c-390f-4d0b-9066-ec2ea9f7065a" alt=""><figcaption></figcaption></figure>

**이런 문제를 해결하기 위해 트랜잭션 전파가 필요한 것이다.**

## 4. 트랜잭션 전파 활용4 - 전파 커밋&#x20;

스프링은 `@Transactional` 이 적용되어 있으면 기본으로 `REQUIRED` 라는 전파 옵션을 사용한다.&#x20;

이 옵션은 기존 트랜잭션이 없으면 트랜잭션을 생성하고, 기존 트랜잭션이 있으면 기존 트랜잭션에 참여한다. 참여한다는 뜻은 해당 트랜잭션을 그대로 따른다는 뜻이고, 동기에 같은 동기화 커넥션을 따른다는 것이다.&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FFtFbxfuMtz30B2s5iJS9%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.55.35.png?alt=media&#x26;token=2ed5ba28-5040-44c5-9b64-f7f11dc6dda5" alt=""><figcaption></figcaption></figure>

이렇게 둘 이상의 트랜잭션이 하나의 물리 트랜잭션에 묶이게 되면 둘을 구분하기 위해 논리 트랜잭션과 물리 트랜잭션으로 구분한다.&#x20;

#### 신규 트랜잭션&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FLTohLCUxuj0J9aKdyoX2%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2008.56.23.png?alt=media&#x26;token=a86ccc6b-1a65-491b-8cbe-a9e44133af91" alt=""><figcaption></figcaption></figure>

* 이 경우 외부에 있는 신규 트랜잭션만 실제 물리 트랜잭션을 시작하고 커밋한다.&#x20;
* 내부에 있는 트랜잭션은 물리 트랜잭션 시작하거나 커밋하지 않는다.&#x20;

#### 모든 논리 트랜잭션 커밋&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FOCSTQTNhrBxXwzHlp7TI%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.02.11.png?alt=media&#x26;token=566d47d1-9ff0-4b0b-a4a6-1c0557fc9a45" alt=""><figcaption></figcaption></figure>

* 모든 논리 트랜잭션을 커밋해야 물리 트랜잭션도 커밋된다. 하나라도 롤백되면 물리 트랜잭션은 롤백된다.&#x20;

먼저 모든 논리 트랜잭션이 정상 커밋되는 경우를 코드로 확인해보자.&#x20;

#### outerTxOn\_success&#x20;

```java
/**
 * memberService    @Transactional:ON
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON
 */
@Test
void outerTxOn_success() {

    // given
    String username = "outerTxOn_success";

    // when
    memberService.joinV1(username);

    // then : 모든 데이터가 정상 저장된다.
    assertTrue(memberRepository.find(username).isPresent());
    assertTrue(logRepository.find(username).isPresent());

}
```

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2F2cwkFZYGPxT0Ix8FKYlG%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.04.37.png?alt=media&#x26;token=c2ba59bd-8c95-40a6-90a9-98ad30555864" alt=""><figcaption></figcaption></figure>

* 클라이언트A(여기서는 테스트 코드)가 `MemberService` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 여기서 신규 트랜잭션이 생성되고, 물리 트랜잭션도 시작한다.
* `MemberRepository` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 이미 트랜잭션이 있으므로 기존 트랜잭션에 참여한다.
* `MemberRepository` 의 로직 호출이 끝나고 정상 응답하면 트랜잭션 AOP가 호출된다.
  * 트랜잭션 AOP는 정상 응답이므로 트랜잭션 매니저에 커밋을 요청한다. 이 경우 신규 트랜잭션이 아니므로 \
    실제 커밋을 호출하지 않는다.
* `LogRepository` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 이미 트랜잭션이 있으므로 기존 트랜잭션에 참여한다.
* `LogRepository` 의 로직 호출이 끝나고 정상 응답하면 트랜잭션 AOP가 호출된다.
  * 트랜잭션 AOP는 정상 응답이므로 트랜잭션 매니저에 커밋을 요청한다. 이 경우 신규 트랜잭션이 아니므로

    실제 커밋(물리 커밋)을 호출하지 않는다.
* `MemberService` 의 로직 호출이 끝나고 정상 응답하면 트랜잭션 AOP가 호출된다.
  * 트랜잭션 AOP 는 정상 응답이므로 트랜잭션 매니저에 커밋을 요청한다. 이 경우 신규 트랜잭션이므로 물리 커밋을 호출한다.&#x20;

## 5. 트랜잭션 전파 활용5 - 전파 롤백&#x20;

이번에는 로그 리포지토리에서 예외가 발생해서 전체 트랜잭션이 롤백되는 경우를 알아보자.&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FEOfxyyyKeXY3VNSl3mAH%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.07.07.png?alt=media&#x26;token=45a8e80d-36ab-4134-a758-a32b1165900f" alt=""><figcaption></figcaption></figure>

#### outerTxOn\_fail&#x20;

```java
/**
 * memberService    @Transactional:ON
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON EXCEPTION
 */
@Test
void outerTxOn_fail() {

    // given
    String username = "로그예외_outerTxOn_fail";

    // when
    assertThatThrownBy(() -> memberService.joinV1(username))
            .isInstanceOf(RuntimeException.class);

    // then : 모든 데이터가 롤백된다.
    assertTrue(memberRepository.find(username).isEmpty());
    assertTrue(logRepository.find(username).isEmpty());

}
```

여기서는 `로그예외` 라고 넘겼기 때문에 `LogRepository` 에서 런타임 예외가 발생한다.

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FCYl3kHV9gdEEvoZVDfUu%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.07.54.png?alt=media&#x26;token=1259af01-5f0b-4d41-ae2e-eee2bbf6a29a" alt=""><figcaption></figcaption></figure>

* 클라이언트A가 `MemberService` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 여기서 신규 트랜잭션이 생성되고, 물리 트랜잭션도 시작한다.
* `MemberRepository` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 이미 트랜잭션이 있으므로 기존 트랜잭션에 참여한다.
* `MemberRepository` 의 로직 호출이 끝나고 정상 응답하면 트랜잭션 AOP가 호출된다.
  * 트랜잭션 AOP는 정상 응답이므로 트랜잭션 매니저에 커밋을 요청한다. 이 경우 신규 트랜잭션이 아니므로

    실제 커밋을 호출하지 않는다.
* `LogRepository` 를 호출하면서 트랜잭션 AOP가 호출된다.
  * 이미 트랜잭션이 있으므로 기존 트랜잭션에 참여한다.
* `LogRepository` 로직에서 런타임 예외가 발생한다. 예외를 던지면 트랜잭션 AOP가 해당 예외를 받게 된다.
  * 트랜잭션 AOP는 런타임 예외가 발생했으므로 트랜잭션 매니저에 롤백을 요청한다. 이 경우 신규 트랜잭션이 아니므로 물리 롤백을 호출하지는 않는다. 대신에 `rollbackOnly` 를 설정한다.
  * `LogRepository` 가 예외를 던졌기 때문에 트랜잭션 AOP도 해당 예외를 그대로 밖으로 던진다.
* `MemberService` 에서도 런타임 예외를 받게 되는데, 여기 로직에서는 해당 런타임 예외를 처리하지 않고 밖으

  로 던진다.

  * 트랜잭션 AOP는 런타임 예외가 발생했으므로 트랜잭션 매니저에 롤백을 요청한다. 이 경우 신규 트랜잭션

    이므로 물리 롤백을 호출한다.
  * 참고로 이 경우 어차피 롤백이 되었기 때문에, `rollbackOnly` 설정은 참고하지 않는다.
  * `MemberService` 가 예외를 던졌기 때문에 트랜잭션 AOP도 해당 예외를 그대로 밖으로 던진다.
* 클라이언트A는 `LogRepository` 부터 넘어온 런타임 예외를 받게 된다.

## 6. 트랜잭션 전파 활용6 - 복구 REQUIRED

앞서 회원과 로그를 하나의 트랜잭션으로 묶어서 데이터 정합성 문제를 깔끔하게 해결했다. 그런데 회원 이력 로그를\
DB에 남기는 작업에 가끔 문제가 발생해서 회원 가입 자체가 안되는 경우가 가끔 발생하게 되었다. 그래서 사용자들이\
회원 가입에 실패해서 이탈하는 문제가 발생하기 시작했다.

회원 이력 로그의 경우 여러가지 방법으로 추후에 복구가 가능할 것으로 보인다. \
그래서 비즈니스 요구사항이 변경되었다.&#x20;

**회원 가입을 시도한 로그를 남기는데 실패하더라도 회원 가입은 유지해야 한다.** &#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FxvOslGXJ6Xu6ISGV1s3g%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.17.48.png?alt=media&#x26;token=071746c2-0399-4f20-b74e-13ee223d80f1" alt=""><figcaption></figcaption></figure>

* 단순하게 생각해보면 `LogRepository` 에서 예외가 발생하면 그것을 `MemberService` 에서 예외를 잡아서 처리하면 될 것 같다.&#x20;
* 이렇게 하면 `MemberService` 에서 정상 흐름으로 바꿀 수 있기 때문에 `MemberService` 의 트랜잭션 AOP 서 커밋을 수행할 수 있다.&#x20;
* 하지만 실패한다..

이 방법이 왜 실패하는지 예제를 통해서 알아보자. 참고로 실무에서 많은 개발자가 이 방법을 사용해서 실패한다.

#### recoverException\_fail&#x20;

```java
/**
 * memberService    @Transactional:ON
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON EXCEPTION
 */
@Test
void recoverException_fail() {

    // given
    String username = "로그예외_recoverException_fail";

    // when
    assertThatThrownBy(() -> memberService.joinV2(username))
            .isInstanceOf(UnexpectedRollbackException.class);

    // then : 모든 데이터가 롤백된다.
    assertTrue(memberRepository.find(username).isEmpty());
    assertTrue(logRepository.find(username).isEmpty());

}
```

**여기서 `memberService.joinV2()`를 호출하는 부분을 주의해야 한다. `joinV2()`에는 예외를 잡아서 정상 흐름으로 변환하는 로직이 추가되어 있다.**

```java
...
try {
    logRepository.save(logMessage);
} catch (RuntimeException e) {
    log.info("log 저장에 실패했습니다. 로그 메시지: {}", logMessage.getMessage());
    log.info("정상 흐름 반환");
}
...
```

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2Fi9S7HDFPcZ645c3dH6og%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.20.39.png?alt=media&#x26;token=64766e9d-833f-4570-bb18-350f0252c4eb" alt=""><figcaption></figcaption></figure>

* 내부 트랜잭션에서 `rollbackOnly` 를 설정하기 때문에 결과적으로 정상 흐름 처리를 해서 외부 트랜잭션에서 커밋을 호출해도 물리 트랜잭션은 롤백된다.&#x20;
* 그리고 `UnexpectedRollbackExcpetion` 이 던져진다.&#x20;

전체 흐름을 조금 더 자세하게 살펴보자.&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2FPg6SSwOs0mNtOT4DMhmy%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.24.53.png?alt=media&#x26;token=d27348fd-cb20-4126-ad0c-86d5781f8dbb" alt=""><figcaption></figcaption></figure>

* `LogRepository` 에서 예외가 발생한다. 예외를 던지면 `LogRepository` 의 트랜잭션 AOP가 해당 예외를 받는다.
* 신규 트랜잭션이 아니므로 물리 트랜잭션을 롤백하지는 않고, 트랜잭션 동기화 매니저에 `rollbackOnly` 를 표시한다.
* 이후 트랜잭션 AOP는 전달 받은 예외를 밖으로 던진다.
* 예외가 `MemberService` 에 던져지고, `MemberService` 는 해당 예외를 복구한다. 그리고 정상적으로 리턴한다.
* 정상 흐름이 되었으므로 `MemberService` 의 트랜잭션 AOP는 커밋을 호출한다.
* 커밋을 호출할 때 신규 트랜잭션이므로 실제 물리 트랜잭션을 커밋해야 한다. 이때 `rollbackOnly` 를 체크한다.
* `rollbackOnly` 가 체크 되어 있으므로 물리 트랜잭션을 롤백한다.
* 트랜잭션 매니저는 `UnexpectedRollbackException` 예외를 던진다.
* 트랜잭션 AOP도 전달받은 `UnexpectedRollbackException` 을 클라이언트에 던진다.

#### 정리&#x20;

* 논리 트랜잭션 중 하나라도 롤백되면 전체 트랜잭션은 롤백된다.&#x20;
* 내부 트랜잭션이 롤백 되었는데, 외부 트랜잭션이 커밋되면 `UnexpectedRollbackException` 예외가 발생한다.&#x20;
* `rollbackOnly` 상황에서 커밋이 발생하면 `UnexpectedRollbackException` 예외가 발생한다.&#x20;

그렇다면 어떻게 해야 다음 요구사항을 만족할 수 있을까?&#x20;

**회원 가입을 시도한 로그를 남기는데 실패하더라도 회원 가입은 유지되어야 한다.**&#x20;

## 7. 트랜잭션 전파 활용7 - 복구 REQUIRES\_NEW&#x20;

**회원 가입을 시도한 로그를 남기는데 실패하더라도 회원 가입은 유지되어야 한다.**

이 요구사항을 만족하기 위해서 로그와 관련된 물리 트랜잭션을 별도로 분리해보자. 바로 `REQUIRES_NEW` 를 사용하는 것이다.

#### recoverException\_success&#x20;

```java
/**
 * memberService    @Transactional:ON
 * memberRepository @Transactional:ON
 * logRepository    @Transactional:ON(REQUIRES_NEW) EXCEPTION
 */
@Test
void recoverException_success() {

    // given
    String username = "로그예외_recoverException_success";

    // when
    memberService.joinV2(username);

    // then : member 저장, log 롤백
    assertTrue(memberRepository.find(username).isPresent());
    assertTrue(logRepository.find(username).isEmpty());

}
```

#### **LogRepository - save()**

```java
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void save(Log logMessage)
```

이렇게 해서 기존 트랜잭션에 참여하는 `REQUIRED` 대신에, 항상 신규 트랜잭션을 생성하는 `REQUIRES_NEW` 를 적용하자.

예외를 복구하는 `memberService.joinV2()` 를 사용한다는 점도 주의하자.&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2Ff55nzhggvNILWLQYRyqf%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.30.15.png?alt=media&#x26;token=61bac49f-afc5-4ebf-9221-2477cc45445e" alt=""><figcaption></figcaption></figure>

* `MemberRepository` 는 `REQUIRED` 옵션을 사용한다. 따라서 기존 트랜잭션에 참여한다.&#x20;
* `LogRepository` 의 트랜잭션 옵션에 `REQUIRES_NEW` 를 사용했다.&#x20;
* `REQUIRES_NEW` 는 항상 새로운 트랜잭션을 만든다. 따라서 해당 트랜잭션 안에서는 DB 커넥션도 별도로 사용하게 된다.&#x20;

#### REQUIRES\_NEW - 복구&#x20;

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2F8T2J605lZhByCUMct66C%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.33.54.png?alt=media&#x26;token=21b0c853-4c0c-4dea-817f-3c54df75d3bb" alt=""><figcaption></figcaption></figure>

* `REQUIRES_NEW` 를 사용하게 되면 물리 트랜잭션 자체가 완전히 분리되어 버린다.
* 그리고 `REQUIRES_NEW` 는 신규 트랜잭션이므로 `rollbackOnly` 표시가 되지 않는다. 그냥 해당 트랜잭션이

  물리 롤백되고 끝난다.

#### **REQUIRES\_NEW - 자세히**

<figure><img src="https://2093748731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMqxl0iBPcO3zyZX5B19%2Fuploads%2F86jgrQE2omQrhJkeitg5%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-06-30%2009.34.34.png?alt=media&#x26;token=3cd9bd91-7e2d-4bb7-b514-b3307a752185" alt=""><figcaption></figcaption></figure>

* `LogRepository` 에서 예외가 발생한다. 예외를 던지면 `LogRepository` 의 트랜잭션 AOP가 해당 예외를 받

  는다.
* `REQUIRES_NEW` 를 사용한 신규 트랜잭션이므로 물리 트랜잭션을 롤백한다. 물리 트랜잭션을 롤백했으므로

  `rollbackOnly` 를 표시하지 않는다. 여기서 `REQUIRES_NEW` 를 사용한 물리 트랜잭션은 롤백되고 완전히 끝이 나버린다.
* 이후 트랜잭션 AOP는 전달 받은 예외를 밖으로 던진다.
* 예외가 `MemberService` 에 던져지고, `MemberService` 는 해당 예외를 복구한다. 그리고 정상적으로 리턴한다.
* 정상 흐름이 되었으므로 `MemberService` 의 트랜잭션 AOP는 커밋을 호출한다.
* 커밋을 호출할 때 신규 트랜잭션이므로 실제 물리 트랜잭션을 커밋해야 한다. 이때 `rollbackOnly` 를 체크한다.
* `rollbackOnly` 가 없으므로 물리 트랜잭션을 커밋한다.
* 이후 정상 흐름이 반환된다.

**결과적으로 회원 데이터는 저장되고, 로그 데이터만 롤백 되는 것을 확인할 수 있다.**

#### **정리**&#x20;

* 논리 트랜잭션은 하나라도 롤백되면 관련된 물리 트랜잭션은 롤백되어 버린다.
* 이 문제를 해결하려면 `REQUIRES_NEW` 를 사용해서 트랜잭션을 분리해야 한다.
* 참고로 예제를 단순화 하기 위해 `MemberService` 가 `MemberRepository`, `LogRepository` 만 호출하지만 실제로는 더 많은 리포지토리들을 호출하고 그 중에 `LogRepository` 만 트랜잭션을 분리한다고 생각해보면

  이해하는데 도움이 될 것이다.

#### 주의&#x20;

* `REQUIRES_NEW` 를 사용하면 하나의 HTTP 요청에 동시에 2개의 데이터베이스 커넥션을 사용하게 된다. \
  따라서 성능이 중요한 곳에서는 이런 부분을 주의해서 사용해야 한다.
* `REQUIRES_NEW` 를 사용하지 않고 문제를 해결할 수 있는 단순한 방법이 있다면, 그 방법을 선택하는 것이 더 좋다.
