@Transactional 특징, 사용방법, 주의점

😤 배경

스프링에서 트랜잭션 처리가 필요한 경우, 나는 간단하게 JPA와 함께 @Transactional 어노테이션을 클래스 혹은 메서드에 설정해 왔다. 그러던 중 최근 운영 중인 서비스에서 Transaction Lock 이슈가 발생하면서 문득 이렇게 막 사용하는 게 옳은 일인가를 고민하게 되었고, 조사 및 정리 차원에서 해당 내용에 대해 작성하게 되었다.

 

해당 포스팅에서는 @Transactional 개념과 원리보다는 특징, 사용 방법, 주의점에 대해서 간단하게 설명하고자 한다.

1. 특징

@Transactional은 다음과 같은 특징을 가지고 있다.

 

- AOP를 통해 구현되었다.

- 어노테이션이 선언된 클래스에 트랜잭션이 적용된 프록시 객체가 생성된다.

- CheckedException 또는 예외가 없는 경우는 메서드가 종료되면서 Commit 처리된다. 
- UncheckedException가 발생하는 경우는 Rollback 처리된다.

- Proxy Mode가 Default로 설정되어있다.

2. 사용 방법

@Transactional 어노테이션을 살펴보면 알 수 있듯이 일반적으로 Service Layer에 클래스 또는 메서드에 적용한다.

Repository Layer에도 선언 가능하지만 선호하지 않는 방법이다. (스프링 공식 문서)

 

개인적으로 선호하는 방식은 클래스 단에 @Transactional(readOnly = true) readOnly 옵션을 부여해서 선언하고,

Create, Update, Delete가 필요한 경우에는 메서드 단에 @Transactional을 선언한다.

Why?

개발 과정에서 실수로 readOnly 옵션을 적용하지 않을 수도 있기 때문이다. readOnly는 JPA와 사용할 때 CUD 처리를 제외함으로써(스냅샷 관리 X) 조회 성능을 향상할 수 있는 중요한 옵션이다. 그러므로 CUD 과정이 필요한 경우 별도로 메서드에 @Transactional을 선언함으로써 실수를 방지할 수 있다.

 

readOnly는 성능 향상 옵션뿐만 아니라 서비스에서 Mater(CRUD), Slave(Read Only)로 데이터베이스를 분리 구성하는 경우, 해당 옵션을 바탕으로 데이터베이스 엔드포인트를 다르게 적용할 수도 있기 때문에 중요 요소이다.

3. 주의점

- 외부 API 요청이 있는 경우는 @Transactional 사용을 고민하자.

 

외부 API 요청은 기본적으로 리소스가 많이 들고 시간이 오래 걸리는 작업이다. 그런데 만약 API 처리가 있는 서비스 메서드에 @Transactional을 선언한다면, 해당 서비스 메서드가 종료될 때까지 트랜잭션이 잡혀있을 것이므로 성능 상으로 문제가 없을지 고민해보아야 한다. 

 

- Propagation.REQUIRES_NEW는 새로운 클래스에 선언해서 사용하자.

 

새로운 트랜잭션(Propagation.REQUIRES_NEW)은 동일한 클래스 내 메서드에서 호출하면 새로 생성되지 않는다. 반드시 다른 클래스에서 선언하고 호출해야 한다.

 

스프링 공식 문서에 따르면, Default Proxy Mode(스프링에서 기본으로 사용하는 Proxy)에서는 프록시를 통해 들어오는 외부(다른 클래스) 메서드 호출만 가로챈다고 한다. 즉, 자체 호출(동일한 클래스에서 다른 메서드를 호출)은 호출된 메서드가 @Transactional가 있어도 런타임 시 실제 트랜잭션으로 이어지지 않는다.

 

공식 문서에 있는 내용이므로, 자세한 원리와 내용은 REFERENCE를 참고하자.

 

- public 메서드에서만 사용 가능하다.

 

스프링 트랜잭션 AOP 기능은 public에서만 트랜잭션을 적용할 수 있도록 기본 설정이 되어있다.

private, protected 메서드에 선언하면 오류가 발생하지는 않지만, 트랜잭션이 적용되지 않는다.

 

- 초기화 시점 이후에 적용이 가능하다.

 

스프링 프레임워크에서는 초기화 코드가 실행된 뒤 트랜잭션 AOP가 적용된다. 그러므로 @PostConstruct 애노테이션과 @Transactional 애노테이션을 같이 사용할 경우 예상과 달리 트랜잭션이 적용되지 않는다.

REFERENCE

https://docs.spring.io/spring-framework/reference/data-access/transaction/declarative/annotations.html

Using @Transactional :: Spring Framework