본문 바로가기

롤백 규칙

예외가 났는데도 행이 남는 경우를 재현하고, 런타임 예외와 검사 예외의 기본 규칙, rollbackFor와 noRollbackFor, 안에서 잡은 예외가 만드는 결과를 행 수로 확인합니다.

앞 글에서 프록시는 메서드가 정상적으로 돌아오면 커밋하고, 예외가 빠져나오면 "롤백 규칙에 따라" 롤백한다고 했습니다. 9장에서 검사 예외가 기본으로는 롤백되지 않는다는 것을 한 번 보았는데, 규칙 전체를 모르면 이상한 일을 더 겪습니다. 메서드가 예외로 끝났는데 행이 저장되어 있거나, 예외를 잡아 정상적으로 끝냈다고 생각했는데 실패 직전의 변경이 그대로 커밋되어 있는 식입니다. 이 글에서는 같은 INSERT 뒤에 서로 다른 방식으로 끝나는 메서드 일곱 개를 만들어, 끝난 뒤 행이 남는지를 하나씩 확인합니다.

이 글을 읽고 나면 다음을 할 수 있습니다.

  • 메서드에서 빠져나온 예외의 종류를 보고 기본 설정에서 커밋될지 롤백될지 예측합니다.
  • rollbackFor와 noRollbackFor로 특정 예외의 결과를 바꿉니다.
  • 예외가 전달되는지와 행이 남는지를 따로 확인하는 테스트를 작성합니다.

앞 글과 같은 프로젝트를 쓰고, 새 파일은 board.tx.proxy.rollback 패키지에 둡니다. 테스트의 뼈대는 앞 글과 같은 모양이며 이번에는 H2 데이터베이스와 트랜잭션 관리자가 하나씩입니다.


예외가 났는데 행이 남는다

서비스의 메서드는 모두 rollback_note 표에 한 행을 넣은 뒤 예외를 던집니다. 먼저 @Transactional에 아무 속성도 주지 않은 세 메서드입니다. ReportExportFailure는 Exception을 상속한 검사 예외이고, NotificationFailure는 RuntimeException을 상속한 비검사 예외입니다.

src/main/java/board/tx/proxy/rollback/RollbackPolicyService.java
package board.tx.proxy.rollback;

import javax.sql.DataSource;

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.transaction.annotation.Transactional;

public class RollbackPolicyService {
    private final JdbcTemplate jdbc;

    public RollbackPolicyService(DataSource dataSource) {
        this.jdbc = new JdbcTemplate(dataSource);
    }

    @Transactional
    public void defaultChecked(long id) throws ReportExportFailure {
        insert(id, "default-checked");
        throw new ReportExportFailure();
    }

    @Transactional
    public void defaultRuntime(long id) {
        insert(id, "default-runtime");
        throw new NotificationFailure();
    }

    @Transactional
    public void defaultError(long id) {
        insert(id, "default-error");
        throw new AssertionError("broken invariant");
    }

    // 뒤에서 여기에 메서드를 추가합니다.

    private void insert(long id, String scenario) {
        jdbc.update(
                "insert into rollback_note(id, scenario) values (?, ?)",
                id,
                scenario
        );
    }

    public static final class ReportExportFailure extends Exception {
        public ReportExportFailure() {
            super("report export failed");
        }
    }

    public static final class NotificationFailure extends RuntimeException {
        public NotificationFailure() {
            super("notification failed");
        }
    }
}

테스트의 뼈대입니다. rows()는 프록시 호출이 끝난 뒤 rollback_note의 행 수를 셉니다.

src/test/java/board/tx/proxy/rollback/RollbackPolicyTest.java
package board.tx.proxy.rollback;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;

import javax.sql.DataSource;

import org.h2.jdbcx.JdbcDataSource;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.aop.support.AopUtils;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;

class RollbackPolicyTest {
    private AnnotationConfigApplicationContext context;
    private JdbcTemplate jdbc;
    private RollbackPolicyService service;

    @BeforeEach
    void openContext() {
        context = new AnnotationConfigApplicationContext(RollbackConfig.class);
        var dataSource = context.getBean(DataSource.class);
        jdbc = new JdbcTemplate(dataSource);
        jdbc.execute("create table if not exists rollback_note(id bigint primary key, scenario varchar(80) not null)");
        jdbc.update("delete from rollback_note");
        service = context.getBean(RollbackPolicyService.class);
    }

    @AfterEach
    void closeContext() {
        context.close();
    }

    // 여기에 테스트 메서드를 추가합니다.

    private int rows() {
        return jdbc.queryForObject(
                "select count(*) from rollback_note",
                Integer.class
        );
    }

    @Configuration(proxyBeanMethods = false)
    @EnableTransactionManagement(proxyTargetClass = true)
    static class RollbackConfig {
        @Bean
        DataSource dataSource() {
            var source = new JdbcDataSource();
            source.setURL("jdbc:h2:mem:b92_proxy_rollback;DB_CLOSE_DELAY=-1");
            source.setUser("sa");
            source.setPassword("");
            return source;
        }

        @Bean
        PlatformTransactionManager transactionManager(DataSource dataSource) {
            return new DataSourceTransactionManager(dataSource);
        }

        @Bean
        RollbackPolicyService rollbackPolicyService(DataSource dataSource) {
            return new RollbackPolicyService(dataSource);
        }
    }
}

이제 세 메서드를 각각 별도의 테스트에서 호출합니다. 각 테스트는 openContext가 행을 지운 빈 테이블에서 시작합니다. 셋 다 INSERT 뒤에 예외를 던지고, 그 예외는 호출한 테스트까지 전달됩니다. 호출이 끝난 뒤 rows()는 각각 몇일까요? 아래 코드의 ? 자리에 들어갈 숫자를 먼저 예상해 보세요.

예상해 볼 코드
assertThrows(ReportExportFailure.class, () -> service.defaultChecked(11L));
// rows() == ?

assertThrows(NotificationFailure.class, () -> service.defaultRuntime(12L));
// rows() == ?

assertThrows(AssertionError.class, () -> service.defaultError(16L));
// rows() == ?
결과 확인하기

차례로 1, 0, 0입니다. 검사 예외가 빠져나온 defaultChecked는 커밋되어 행이 남고, 런타임 예외와 Error가 빠져나온 두 메서드는 롤백되어 행이 없습니다. 세 경우 모두 예외는 호출한 쪽에 그대로 전달됩니다. 예외가 전달되는 것과 트랜잭션이 어떻게 끝나는지는 서로 다른 일입니다.

이 예상을 테스트로 옮겨 실행합니다.

RollbackPolicyTest.java - 기본 규칙
    @Test
    void escaping_checked_exception_commits_by_default() {
        assertThrows(
                RollbackPolicyService.ReportExportFailure.class,
                () -> service.defaultChecked(11L)
        );

        assertEquals(1, rows());
    }

    @Test
    void escaping_runtime_exception_rolls_back_by_default() {
        assertThrows(
                RollbackPolicyService.NotificationFailure.class,
                () -> service.defaultRuntime(12L)
        );

        assertEquals(0, rows());
    }

    @Test
    void escaping_error_rolls_back_through_the_transaction_proxy() {
        assertTrue(AopUtils.isAopProxy(service));
        assertThrows(
                AssertionError.class,
                () -> service.defaultError(16L)
        );

        assertEquals(0, rows());
    }
테스트 실행
./gradlew test --tests board.tx.proxy.rollback.RollbackPolicyTest

Spring의 기본 규칙은 다음 표와 같습니다. 예외 이름에 Business가 들어 있는지, 메시지에 어떤 단어가 있는지는 판단에 쓰이지 않습니다.

메서드가 끝난 방식기본 결과
정상 반환커밋
RuntimeException이나 그 하위 타입이 빠져나옴롤백
Error나 그 하위 타입이 빠져나옴롤백
검사 예외가 빠져나옴커밋

검사 예외에 커밋하는 것은 자바의 관습에서 온 기본값입니다. 검사 예외는 호출한 쪽이 처리할 것으로 예상되는 결과이고, 런타임 예외는 예상하지 못한 결함이라는 구분입니다. 하지만 "보고서를 만들지 못했으면 방금 넣은 행도 없어야 한다"는 요구는 이 관습과 무관하므로, 그럴 때는 규칙을 직접 적어야 합니다.


rollbackFor와 noRollbackFor로 결과를 바꾼다

서비스에 네 메서드를 추가합니다.

RollbackPolicyService.java - 메서드 네 개 추가
    @Transactional(rollbackFor = ReportExportFailure.class)
    public void rollbackChecked(long id) throws ReportExportFailure {
        insert(id, "rollback-checked");
        throw new ReportExportFailure();
    }

    @Transactional(noRollbackFor = NotificationFailure.class)
    public void commitRuntime(long id) {
        insert(id, "commit-runtime");
        throw new NotificationFailure();
    }

    @Transactional(
            rollbackFor = Exception.class,
            noRollbackFor = NotificationFailure.class
    )
    public void specificNoRollbackWins(long id) {
        insert(id, "specific-no-rollback");
        throw new NotificationFailure();
    }

    @Transactional
    public boolean catchRuntimeAndReturn(long id) {
        insert(id, "caught-runtime");
        try {
            throw new NotificationFailure();
        } catch (NotificationFailure handled) {
            return false;
        }
    }

rollbackFor는 "이 예외가 빠져나오면 검사 예외여도 롤백한다"는 뜻이고, noRollbackFor는 "이 예외가 빠져나와도 커밋한다"는 뜻입니다. rollbackChecked와 commitRuntime은 앞의 기본 결과를 각각 뒤집습니다.

나머지 두 메서드는 예상하기 어렵습니다. specificNoRollbackWins에는 Exception에 롤백하라는 규칙과 NotificationFailure에 롤백하지 말라는 규칙이 함께 있고, 던져진 NotificationFailure는 두 규칙에 모두 맞습니다. catchRuntimeAndReturn은 런타임 예외가 나지만 메서드 안에서 잡고 false를 돌려줍니다. 두 메서드를 호출한 뒤 행은 각각 남을까요? 먼저 예상해 보세요.

결과 확인하기

둘 다 행이 남습니다. 규칙이 여럿 맞을 때는 던져진 예외의 실제 타입에 더 가까운 규칙이 이깁니다. NotificationFailure에게는 자기 자신을 가리키는 noRollbackFor가 조상인 Exception을 가리키는 rollbackFor보다 가까우므로 커밋됩니다.

catchRuntimeAndReturn에서는 프록시가 예외를 보지 못합니다. 프록시가 판단에 쓰는 것은 메서드 밖으로 빠져나온 예외뿐인데, 예외는 메서드 안에서 잡혔고 프록시가 본 것은 정상 반환입니다. 그래서 실패 직전에 넣은 행이 그대로 커밋됩니다.

RollbackPolicyTest.java - 규칙을 적은 메서드와 안에서 잡은 예외
    @Test
    void rollback_for_rolls_back_the_named_checked_exception() {
        assertThrows(
                RollbackPolicyService.ReportExportFailure.class,
                () -> service.rollbackChecked(13L)
        );

        assertEquals(0, rows());
    }

    @Test
    void no_rollback_for_commits_the_named_runtime_exception() {
        assertThrows(
                RollbackPolicyService.NotificationFailure.class,
                () -> service.commitRuntime(14L)
        );

        assertEquals(1, rows());
    }

    @Test
    void specific_no_rollback_rule_beats_the_matching_broad_rollback_rule() {
        assertThrows(
                RollbackPolicyService.NotificationFailure.class,
                () -> service.specificNoRollbackWins(17L)
        );

        assertEquals(1, rows());
    }

    @Test
    void caught_exception_becomes_normal_return_to_the_interceptor() {
        assertFalse(service.catchRuntimeAndReturn(15L));

        assertEquals(1, rows());
    }

일곱 테스트를 모두 넣고 실행해 통과하는지 확인합니다. 테스트마다 예외가 전달되는지와 행 수를 둘 다 확인한다는 점을 눈여겨보세요. 예외가 났다는 것만 확인해서는 커밋과 롤백을 구별할 수 없습니다.

밖으로 나온 예외와 가장 구체적인 규칙이 완료 결정을 만든다

밖으로 나온 예외의 명시 규칙과 기본 규칙을 판정해 commit 시도 또는 rollback으로 갈라지는 순서가 있습니다.

EXCEPTION ESCAPE · STRONGEST RULE · COMPLETION

밖으로 나온 예외에 가장 구체적인 규칙을 적용한다

이 교재의 동기식 호출은 Spring 기본 롤백 설정을 사용합니다. 정상 반환과 예외 전달을 먼저 구분하고 예외에는 명시 규칙을 우선합니다.

정상 종료와 예외 규칙의 판단일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.밖으로 예외?커밋 시도명시 규칙 일치?가장 구체 타입 규칙rollback / commit 시도RuntimeException또는 Error?롤백커밋 시도아니오예예아니오예아니오
같은 롤백 판정 순서일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.밖으로예외?커밋 시도명시 규칙일치?가장 구체타입 규칙따른 완료런타임또는 Error?롤백커밋 시도아니오예예아니오예아니오
  1. 정상 반환인가, 예외가 빠져나왔는가

    내부에서 잡아 정상 값을 반환한 예외는 인터셉터에 도달하지 않습니다. 정상 반환은 커밋을 시도합니다.

  2. 예외와 일치하는 명시 규칙을 확인

    rollbackFor / noRollbackFor 가운데 실제 타입에 가장 가까운 규칙이 이깁니다.

  3. 일치 규칙이 없을 때 기본값 적용

    RuntimeException·Error는 롤백, 검사 예외는 커밋 시도입니다. 예외 전달 여부와 완료 결정은 별개입니다.

명시 규칙 · rollbackFor

검사 예외도 함께 롤백

예: 보고서 생성 실패와 현재 변경을 함께 무효화해야 할 때.

명시 규칙 · noRollbackFor

런타임 예외여도 커밋 시도

예: 핵심 상태가 유효한 알림 실패. 구체 규칙이 넓은 Exception 규칙보다 우선합니다.

기본값 · RuntimeException / Error

메서드 밖으로 나오면 롤백

대상 메서드 안에서 처리한 예외에는 이 기본 판단을 적용하지 않습니다.

기본값 · 검사 예외 / 정상 반환

커밋 시도

이미 rollback-only인 참여 트랜잭션이나 커밋 단계 오류까지 성공한다는 뜻은 아닙니다.

규칙 입력과 최종 DB 행을 함께 검증합니다. 완료된 커밋 뒤 외부 전달 실패는 별도 전달 구조로 처리합니다.

이 예의 조건

  • 두 박스는 같은 실행의 진행 정보와 자료·결과를 보여 주는 고정 역할입니다. 박스의 좌우·위아래 위치를 별도 호출 순서로 해석하지 않습니다.
  • 조건별 종료는 대안입니다. 실패 뒤 정상 후속 단계를 실행하거나 독립 비교 사례를 같은 요청으로 연결하지 않습니다.
  • 일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.
관계도의 보충 설명
전체 그림의 표시 문구·조건·주석
순번원문 표시
1밖으로 나온 예외와 가장 구체적인 규칙이 완료 결정을 만든다
10가장 구체적인 타입 규칙
15아니요
34예: 검사 예외로 표현한 보고서 생성 실패와 현재 변경을 함께 무효화해야 할 때.
단계별 상태·값과 전환 이유
장면관찰 값전환 이유
밖으로 나온 결과

일반 동기 메서드 밖으로 예외가 나왔는지 확인합니다.

예외 없음: commit 시도 · 예외 있음: 규칙 탐색정상·예외 결과가 완료 판단 입력이 됩니다.
가장 구체적 명시 규칙

일치하는 명시 타입 규칙을 선택합니다.

rollbackFor: rollback · noRollbackFor: commit 시도구체적인 규칙이 기본 분류에 우선합니다.
미일치 기본 규칙

명시 규칙이 없으면 RuntimeException·Error는 rollback이고 checked는 commit 시도입니다.

기본: runtime rollback·checked commit 시도 · 완료 성공: 보장 아님예외 타입에 따라 완료 시도가 갈립니다.

밖으로 나온 예외와 가장 구체적인 규칙이 완료 결정을 만든다

밖으로 나온 예외의 명시 규칙과 기본 규칙을 판정해 commit 시도 또는 rollback으로 갈라지는 순서가 있습니다.

EXCEPTION ESCAPE · STRONGEST RULE · COMPLETION

밖으로 나온 예외에 가장 구체적인 규칙을 적용한다

이 교재의 동기식 호출은 Spring 기본 롤백 설정을 사용합니다. 정상 반환과 예외 전달을 먼저 구분하고 예외에는 명시 규칙을 우선합니다.

정상 종료와 예외 규칙의 판단일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.밖으로 예외?커밋 시도명시 규칙 일치?가장 구체 타입 규칙rollback / commit 시도RuntimeException또는 Error?롤백커밋 시도아니오예예아니오예아니오
같은 롤백 판정 순서일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.밖으로예외?커밋 시도명시 규칙일치?가장 구체타입 규칙따른 완료런타임또는 Error?롤백커밋 시도아니오예예아니오예아니오
  1. 정상 반환인가, 예외가 빠져나왔는가

    내부에서 잡아 정상 값을 반환한 예외는 인터셉터에 도달하지 않습니다. 정상 반환은 커밋을 시도합니다.

  2. 예외와 일치하는 명시 규칙을 확인

    rollbackFor / noRollbackFor 가운데 실제 타입에 가장 가까운 규칙이 이깁니다.

  3. 일치 규칙이 없을 때 기본값 적용

    RuntimeException·Error는 롤백, 검사 예외는 커밋 시도입니다. 예외 전달 여부와 완료 결정은 별개입니다.

명시 규칙 · rollbackFor

검사 예외도 함께 롤백

예: 보고서 생성 실패와 현재 변경을 함께 무효화해야 할 때.

명시 규칙 · noRollbackFor

런타임 예외여도 커밋 시도

예: 핵심 상태가 유효한 알림 실패. 구체 규칙이 넓은 Exception 규칙보다 우선합니다.

기본값 · RuntimeException / Error

메서드 밖으로 나오면 롤백

대상 메서드 안에서 처리한 예외에는 이 기본 판단을 적용하지 않습니다.

기본값 · 검사 예외 / 정상 반환

커밋 시도

이미 rollback-only인 참여 트랜잭션이나 커밋 단계 오류까지 성공한다는 뜻은 아닙니다.

규칙 입력과 최종 DB 행을 함께 검증합니다. 완료된 커밋 뒤 외부 전달 실패는 별도 전달 구조로 처리합니다.

이 예의 조건

  • 두 박스는 같은 실행의 진행 정보와 자료·결과를 보여 주는 고정 역할입니다. 박스의 좌우·위아래 위치를 별도 호출 순서로 해석하지 않습니다.
  • 조건별 종료는 대안입니다. 실패 뒤 정상 후속 단계를 실행하거나 독립 비교 사례를 같은 요청으로 연결하지 않습니다.
  • 일반 동기식 메서드와 기본 설정의 판단 순서입니다. 밖으로 나온 예외가 없으면 commit을 시도하고, 있으면 가장 구체적인 명시 타입 규칙을 고릅니다. rollbackFor면 rollback, noRollbackFor면 commit 시도입니다. 일치하는 규칙이 없으면 RuntimeException/Error는 rollback, checked 예외는 commit 시도입니다. 이미 rollback-only인 공유 트랜잭션이나 commit 실패까지 성공한다는 뜻은 아닙니다.

관계도의 보충 설명

전체 그림의 표시 문구·조건·주석
순번원문 표시
1밖으로 나온 예외와 가장 구체적인 규칙이 완료 결정을 만든다
10가장 구체적인 타입 규칙
15아니요
34예: 검사 예외로 표현한 보고서 생성 실패와 현재 변경을 함께 무효화해야 할 때.
단계별 상태·값과 전환 이유
장면관찰 값전환 이유
밖으로 나온 결과

일반 동기 메서드 밖으로 예외가 나왔는지 확인합니다.

예외 없음: commit 시도 · 예외 있음: 규칙 탐색정상·예외 결과가 완료 판단 입력이 됩니다.
가장 구체적 명시 규칙

일치하는 명시 타입 규칙을 선택합니다.

rollbackFor: rollback · noRollbackFor: commit 시도구체적인 규칙이 기본 분류에 우선합니다.
미일치 기본 규칙

명시 규칙이 없으면 RuntimeException·Error는 rollback이고 checked는 commit 시도입니다.

기본: runtime rollback·checked commit 시도 · 완료 성공: 보장 아님예외 타입에 따라 완료 시도가 갈립니다.

그림은 프록시가 판단하는 순서입니다. 밖으로 나온 예외가 없으면 커밋하고, 있으면 먼저 그 예외에 맞는 규칙을 찾아 가장 가까운 규칙을 따릅니다. 맞는 규칙이 없을 때만 런타임 예외와 Error는 롤백, 검사 예외는 커밋이라는 기본값으로 내려갑니다.

일곱 메서드의 결과를 한 표로 모으면 다음과 같습니다.

메서드빠져나온 예외적용된 규칙남은 행
defaultChecked검사 예외기본값1
defaultRuntime런타임 예외기본값0
defaultErrorError기본값0
rollbackChecked검사 예외rollbackFor0
commitRuntime런타임 예외noRollbackFor1
specificNoRollbackWins런타임 예외더 가까운 noRollbackFor1
catchRuntimeAndReturn없음정상 반환1

규칙은 구체적인 타입으로 좁게 적는다

rollbackFor = Exception.class처럼 넓은 규칙은 편해 보이지만, 모든 검사 예외와 프로그래밍 결함을 한 가지 정책으로 묶습니다. 어떤 실패에 어떤 결과를 원하는지 먼저 정하고, 그 실패를 나타내는 구체적인 타입을 규칙에 씁니다.

예외 클래스의 상속 구조를 바꾸면 규칙의 결과도 바뀔 수 있습니다. 검사 예외였던 클래스를 RuntimeException의 하위로 옮기면 커밋되던 메서드가 롤백되기 시작합니다. 그래서 규칙이 있는 메서드는 실제 예외 타입마다 행 수를 확인하는 테스트를 함께 둡니다.


더 깊이

문자열 규칙의 일치 방식과 6.2의 전역 기본값

rollbackForClassName처럼 클래스 이름을 문자열로 적는 규칙도 있지만 일치 방식이 달라 위험합니다. Spring 레퍼런스의 롤백 규칙에 따르면 rollbackFor처럼 타입으로 정한 규칙은 던져진 예외가 그 타입이거나 하위 타입일 때만 맞습니다. 반면 rollbackForClassName의 패턴은 던져진 예외의 이름에 그 문자열이 들어 있기만 하면 맞습니다. 그래서 "Exception"은 거의 모든 예외와 맞아 다른 규칙을 가리고, "com.example.CustomException"은 같은 패키지의 CustomExceptionV2나 중첩 클래스 CustomException$AnotherException과도 맞습니다. 여러 규칙이 함께 맞을 때는 가장 강하게 맞는 규칙 하나가 결과를 정합니다.

Spring Framework 6.2부터는 규칙이 없는 예외의 기본 처리 자체를 바꿀 수 있습니다. @EnableTransactionManagement(rollbackOn = RollbackOn.ALL_EXCEPTIONS)로 선언하면, 규칙 기반 트랜잭션은 검사 예외를 포함한 모든 예외에서 롤백합니다. API 문서는 메서드마다 적은 규칙이 이 기본값보다 우선하되, 규칙에 없는 예외에는 고른 기본값이 그대로 적용된다고 설명합니다. 또 커밋하는 EJB 방식의 업무 예외에 기대지 않는다면 이 설정으로 바꾸기를 권하고, 검사 예외를 강제하지 않는 Kotlin 애플리케이션에도 같은 권고를 합니다. 이 설정을 켜면 기본 규칙 표에서 검사 예외의 결과가 롤백으로 바뀌므로, 검사 예외 뒤에도 커밋해야 하는 경우에만 noRollbackFor를 남기면 됩니다.

롤백 규칙이 다루지 못하는 실패

커밋은 메서드가 돌아온 뒤 프록시가 실행하므로, 커밋 단계에서 난 실패는 메서드 안의 try 블록으로 잡을 수 없습니다. 호출한 쪽이 프록시 호출 전체의 실패로 받아 처리합니다. 또 커밋이 끝난 뒤에 실행한 메일 발송이나 외부 API 호출이 실패해도 이미 커밋된 DB는 되돌아가지 않습니다. 이런 전달은 롤백 규칙이 아니라 감사 로그와 아웃박스에서 다루는 별도의 구조로 풉니다.


정리

  • 기본 설정에서 밖으로 나온 RuntimeException과 Error는 롤백되고, 검사 예외와 정상 반환은 커밋됩니다.
  • 프록시는 메서드 밖으로 빠져나온 예외만 봅니다. 안에서 잡고 정상 반환하면 그 전의 변경이 커밋됩니다.
  • rollbackFor와 noRollbackFor가 함께 맞으면 실제 타입에 더 가까운 규칙이 이깁니다.
  • 테스트는 예외가 전달되는지와 최종 행 수를 함께 확인해야 커밋과 롤백을 구별할 수 있습니다.

연습 문제

1. 규칙에 맞지 않는 예외

다음 세 경우에 INSERT한 행이 남는지 예상해 보세요. 세 메서드 모두 INSERT 뒤에 예외를 던지고 잡지 않습니다.

  • 가: @Transactional(rollbackFor = Exception.class)인 메서드가 NotificationFailure를 던진다.
  • 나: @Transactional(noRollbackFor = NotificationFailure.class)인 메서드가 IllegalStateException을 던진다.
  • 다: @Transactional(rollbackFor = ReportExportFailure.class)인 메서드가 검사 예외인 java.io.IOException을 던진다.
해설 보기

가는 남지 않습니다. NotificationFailure는 Exception의 하위 타입이므로 rollbackFor 규칙에 맞아 롤백됩니다. 나도 남지 않습니다. IllegalStateException은 NotificationFailure와 상속 관계가 없어 규칙에 맞지 않고, 기본값으로 내려가 런타임 예외이므로 롤백됩니다. 다는 남습니다. IOException은 ReportExportFailure의 하위 타입이 아니어서 규칙에 맞지 않고, 기본값에서 검사 예외는 커밋되기 때문입니다. 규칙을 하나 적었다고 다른 예외의 기본값까지 바뀌지는 않습니다.

2. 실패를 숨기면서 행은 남기지 않기

catchRuntimeAndReturn은 알림 실패를 호출한 쪽에 예외로 알리지 않고 false를 돌려줍니다. 그런데 요구가 바뀌어, false를 돌려주는 것은 그대로 두되 그 전에 넣은 행은 남지 않아야 합니다. 새 메서드 catchRuntimeAndRollback을 만들고 테스트로 확인하세요.

힌트: Spring 레퍼런스의 롤백 규칙 문서에는 메서드 안에서 현재 트랜잭션을 롤백하도록 표시하는 TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()가 나옵니다.

해설 보기
RollbackPolicyService.java - 메서드 추가
    @Transactional
    public boolean catchRuntimeAndRollback(long id) {
        insert(id, "caught-rollback");
        try {
            throw new NotificationFailure();
        } catch (NotificationFailure handled) {
            TransactionAspectSupport.currentTransactionStatus()
                    .setRollbackOnly();
            return false;
        }
    }
RollbackPolicyTest.java - 테스트 추가
    @Test
    void caught_exception_can_still_mark_the_transaction_for_rollback() {
        assertFalse(service.catchRuntimeAndRollback(18L));

        assertEquals(0, rows());
    }

서비스 파일에 import org.springframework.transaction.interceptor.TransactionAspectSupport;를 추가합니다. 프록시는 이번에도 정상 반환을 보지만, 커밋하려는 순간 트랜잭션에 롤백 표시가 있는 것을 확인하고 커밋 대신 롤백합니다. 그래서 false가 돌아오고 행은 없습니다.

3. 포인트가 모자라면 기록도 남지 않게

포인트를 쓰는 서비스를 만드세요. 처음에는 규칙 없이 만들어 실패하는 테스트를 본 다음 고칩니다.

  • board.tx.proxy.rollback 패키지에 PointUseService를 만듭니다. use(long id, int balance, int cost)는 rollback_note에 scenario가 point-use인 행을 넣고, cost가 balance보다 크면 검사 예외 PointShortage를 던집니다.
  • 포인트가 충분하면 행이 1개 남습니다.
  • 포인트가 모자라면 PointShortage가 호출한 쪽에 전달되고 행은 0개입니다.
해설 보기
src/main/java/board/tx/proxy/rollback/PointUseService.java
package board.tx.proxy.rollback;

import javax.sql.DataSource;

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.transaction.annotation.Transactional;

public class PointUseService {
    private final JdbcTemplate jdbc;

    public PointUseService(DataSource dataSource) {
        this.jdbc = new JdbcTemplate(dataSource);
    }

    @Transactional(rollbackFor = PointShortage.class)
    public void use(long id, int balance, int cost) throws PointShortage {
        jdbc.update(
                "insert into rollback_note(id, scenario) values (?, ?)",
                id,
                "point-use"
        );
        if (cost > balance) {
            throw new PointShortage(balance, cost);
        }
    }

    public static final class PointShortage extends Exception {
        public PointShortage(int balance, int cost) {
            super("point shortage: balance=" + balance + ", cost=" + cost);
        }
    }
}
RollbackPolicyTest.java - RollbackConfig에 빈 추가
        @Bean
        PointUseService pointUseService(DataSource dataSource) {
            return new PointUseService(dataSource);
        }
RollbackPolicyTest.java - 테스트 두 개 추가
    @Test
    void enough_points_keep_the_row() throws Exception {
        context.getBean(PointUseService.class).use(21L, 100, 30);

        assertEquals(1, rows());
    }

    @Test
    void point_shortage_removes_the_row() {
        var points = context.getBean(PointUseService.class);

        assertThrows(
                PointUseService.PointShortage.class,
                () -> points.use(22L, 10, 30)
        );

        assertEquals(0, rows());
    }

rollbackFor를 빼고 @Transactional만 붙인 상태로 먼저 실행하면 둘째 테스트가 실패합니다. 기대한 행 수는 0인데 실제는 1입니다. PointShortage가 검사 예외여서 기본 규칙으로 커밋되었기 때문입니다. rollbackFor = PointShortage.class를 적으면 두 테스트가 모두 통과합니다. PointShortage를 RuntimeException의 하위로 만들어도 같은 결과가 나오며, 이 장의 뒤쪽 예제들은 그 방식을 씁니다.

지금까지의 테스트는 모두 컨테이너에서 꺼낸 빈의 메서드를 밖에서 호출했습니다. 다음 글 트랜잭션 프록시 우회에서는 같은 클래스 안에서 @Transactional 메서드를 호출할 때 이 규칙들이 아예 적용되지 않는 경우를 재현합니다.