📌 Spring Boot 트랜잭션 분리 설정 (MyBatis + JPA)

📅 날짜

2025-05-08

📝 학습 내용

1️⃣ 트랜잭션 분리의 필요성

• MyBatis와 JPA는 내부 트랜잭션 매커니즘이 다르기 때문에 트랜잭션 매니저가 충돌할 수 있다.
• Spring에서는 @Transactional에서 사용할 트랜잭션 매니저를 명시적으로 지정함으로써 혼선을 방지할 수 있다.

---

2️⃣ 설정 파일 정리

✅ TxConfig.java

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        basePackages ="com.example.demo.domain.repository",
        transactionManagerRef = "jpaTransactionManager"
)
public class TxConfig {

    @Autowired
    private DataSource dataSource;

    // MyBatis 또는 기본 JDBC용 트랜잭션 매니저
    @Bean(name = "dataSourceTransactionManager")
    public DataSourceTransactionManager transactionManager2() {
        return new DataSourceTransactionManager(dataSource);
    }

    // JPA용 트랜잭션 매니저
    @Bean(name = "jpaTransactionManager")
    public JpaTransactionManager jpaTransactionManager(EntityManagerFactory entityManagerFactory) {
        JpaTransactionManager transactionManager = new JpaTransactionManager();
        transactionManager.setEntityManagerFactory(entityManagerFactory);
        transactionManager.setDataSource(dataSource);
        return transactionManager;
    }
}

---

✅ JpaConfig.java

@Configuration
@EntityScan(basePackages = {"com.example.demo.domain.entity"})
@EnableJpaRepositories(
        basePackages = {"com.example.demo.domain.repository"},
        transactionManagerRef = "jpaTransactionManager"
)
public class JpaConfig {

    @Autowired
    private DataSource dataSource;

    @Bean
    LocalContainerEntityManagerFactoryBean entityManagerFactory() {
        LocalContainerEntityManagerFactoryBean factoryBean = new LocalContainerEntityManagerFactoryBean();
        factoryBean.setDataSource(dataSource);
        factoryBean.setJpaVendorAdapter(new HibernateJpaVendorAdapter());
        factoryBean.setPackagesToScan("com.example.demo.domain.entity");

        Map<String, Object> properties = new HashMap<>();
        properties.put("hibernate.hbm2ddl.auto", "update");
        properties.put("hibernate.dialect", "org.hibernate.dialect.MySQLDialect");
        properties.put("hibernate.show_sql", true);
        properties.put("hibernate.format_sql", true);
        factoryBean.setJpaPropertyMap(properties);

        return factoryBean;
    }

    // ⚠️ 실무에서는 dev 환경에서만 동작하도록 @Profile("dev") 추가 권장
    @Bean
    public DataSourceInitializer dataSourceInitializer() {
        DataSourceInitializer initializer = new DataSourceInitializer();
        initializer.setDataSource(dataSource);
        initializer.setDatabasePopulator(databasePopulator());
        return initializer;
    }

    private DatabasePopulator databasePopulator() {
        ResourceDatabasePopulator populator = new ResourceDatabasePopulator();
        populator.addScript(new ClassPathResource("schema.sql"));
        populator.addScript(new ClassPathResource("data.sql"));
        return populator;
    }
}

---

3️⃣ 트랜잭션 서비스 예제

✅ TxTestService.java

@Service
@Slf4j
public class TxTestService {

    @Autowired
    private MemoMapper memoMapper;

    @Transactional(rollbackFor = SQLException.class, transactionManager = "dataSourceTransactionManager")
    public void addMemoTx(MemoDto dto) throws Exception {
        log.info("MyBatis Insert 실행");
        memoMapper.insert(dto);
        throw new SQLException(); // 롤백 테스트용 예외
    }

    @Autowired
    private MemoRepository memoRepository;

    @Transactional(rollbackFor = SQLException.class, transactionManager = "jpaTransactionManager")
    public void addMemoTx2(MemoDto dto) throws Exception {
        log.info("JPA Insert 실행");
        Memo memo = new Memo();
        memo.setId(dto.getId());
        memo.setText(dto.getText());
        memoRepository.save(memo);
        throw new SQLException(); // 롤백 테스트용 예외
    }
}

---

4️⃣ 단위 테스트 코드

✅ TxTestServiceTest.java

@SpringBootTest
class TxTestServiceTest {

    @Autowired
    private TxTestService txTestService;

    @Test
    void t2() throws Exception {
        txTestService.addMemoTx(new MemoDto(1, "TEST1")); // MyBatis 트랜잭션 테스트
    }

    @Test
    void t3() throws Exception {
        txTestService.addMemoTx2(new MemoDto(1, "TEST1")); // JPA 트랜잭션 테스트
    }
}

---

🔥 정리

• MyBatis와 JPA 각각 다른 트랜잭션 매니저를 사용하면 충돌 없이 병행 사용 가능
• @Transactional(transactionManager = "...")로 명시 지정 필수
• 초기화 스크립트는 @Profile("dev") 등으로 분리하는 것이 실무에 적합
• 테스트 코드로 롤백 여부를 확인하며 안정성 확보 가능

---

🔗 참고 자료

• Spring 공식 문서 - 트랜잭션 관리
• Baeldung - Multiple Transaction Managers in Spring

---

느낀 점

이번 실습을 통해 하나의 프로젝트에서 MyBatis와 JPA를 동시에 사용할 때 발생할 수 있는 트랜잭션 충돌 문제를 사전에 예방할 수 있었다. 트랜잭션 매니저를 명확히 구분하고 테스트로 검증하는 과정은 실무에서도 매우 유용할 것이다.

---