快捷導(dǎo)航

Spring Boot 自動(dòng)配置中的Spring transaction詳解

更新時(shí)間：2025年09月30日 16:37:14 作者：FrankYoou

Spring Boot通過TransactionAutoConfiguration 自動(dòng)裝配事務(wù)管理器和 TransactionTemplate,讓開發(fā)者在引入數(shù)據(jù)源依賴后即可開箱即用事務(wù)功能,無需手動(dòng)配置,本文給大家介紹Spring Boot 自動(dòng)配置中的Spring transaction,感興趣的朋友跟隨小編一起看看吧

什么是 Spring 事務(wù)

Spring 事務(wù)是 Spring 框架提供的一種統(tǒng)一事務(wù)管理機(jī)制，用來保證數(shù)據(jù)操作的一致性和完整性。它通過聲明式（基于注解或 XML 配置）或編程式（手動(dòng)調(diào)用 API）兩種方式，簡(jiǎn)化了事務(wù)的開啟、提交和回滾邏輯。底層上，Spring 事務(wù)抽象屏蔽了不同持久化技術(shù)（如 JDBC、Hibernate、JPA）的差異，讓開發(fā)者能以一致的方式處理事務(wù)，從而避免數(shù)據(jù)不一致或部分提交的問題。

換句話說，Spring 事務(wù)的核心價(jià)值在于：簡(jiǎn)化事務(wù)管理、統(tǒng)一編程模型、確保數(shù)據(jù)安全可靠。

Spring Boot 自動(dòng)配置類 TransactionAutoConfiguration

包：org.springframework.boot.autoconfigure.transaction

類：TransactionAutoConfiguration

自動(dòng)配置的部分核心源代碼如下：

@AutoConfiguration
@ConditionalOnClass(PlatformTransactionManager.class)
public class TransactionAutoConfiguration {
	@Configuration(proxyBeanMethods = false)
	@ConditionalOnSingleCandidate(PlatformTransactionManager.class)
	public static class TransactionTemplateConfiguration {
		@Bean
		@ConditionalOnMissingBean(TransactionOperations.class)
		public TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
			return new TransactionTemplate(transactionManager);
		}
	}
	@Configuration(proxyBeanMethods = false)
	@ConditionalOnBean(TransactionManager.class)
	@ConditionalOnMissingBean(AbstractTransactionManagementConfiguration.class)
	public static class EnableTransactionManagementConfiguration {
		@Configuration(proxyBeanMethods = false)
		@EnableTransactionManagement(proxyTargetClass = false)
		@ConditionalOnBooleanProperty(name = "spring.aop.proxy-target-class", havingValue = false)
		public static class JdkDynamicAutoProxyConfiguration {
		}
		@Configuration(proxyBeanMethods = false)
		@EnableTransactionManagement(proxyTargetClass = true)
		@ConditionalOnBooleanProperty(name = "spring.aop.proxy-target-class", matchIfMissing = true)
		public static class CglibAutoProxyConfiguration {
		}
	}
}

下面我們拆開來分析

@ConditionalOnClass(PlatformTransactionManager.class)

Spring Boot 自動(dòng)配置的先決條件是類路徑 classpath 下存在 PlatformTransactionManager 這個(gè)類；Spring Boot 下引用 “spring-boot-starter-jdbc” 這個(gè)依賴時(shí)會(huì)間接引用這個(gè)類的。

    @Configuration(proxyBeanMethods = false)
	@ConditionalOnSingleCandidate(PlatformTransactionManager.class)
	public static class TransactionTemplateConfiguration {
		@Bean
		@ConditionalOnMissingBean(TransactionOperations.class)
		public TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
			return new TransactionTemplate(transactionManager);
		}
	}

使用 Spring 事務(wù)，必須要給到 PlatformTransactionManager ，這里要求 Spring 容器中必須存在唯一候選的實(shí)現(xiàn) PlatformTransactionManager 接口的類的 Bean，自定義 Bean 的代碼可以參考如下：

@Configuration
public class DataSourceConfig {
    @Bean
    @ConditionalOnMissingBean
    public DataSource dataSource() {
        return new DriverManagerDataSource("jdbc:mysql://localhost:3306/your_database", "username", "password");
    }
    @Bean
    @ConditionalOnMissingBean
    public PlatformTransactionManager transactionManager(DataSource dataSource) {
        return new DataSourceTransactionManager(dataSource);
    }
}

如果 Spring 容器中不存在 TransactionOperations 接口實(shí)現(xiàn)類的 Bean 的話，會(huì)自動(dòng)創(chuàng)建一個(gè) 單例的 Bean（TransactionTemplate 類實(shí)現(xiàn)了 TransactionOperations 接口），此 Bean 的名稱為 “transactionTemplate”。

那 TransactionTemplate 都使用在哪些場(chǎng)景呢？

TransactionTemplate 是 Spring 提供的編程式事務(wù)管理工具，用于在代碼中顯式控制事務(wù)的開啟、提交和回滾。
它通過回調(diào)機(jī)制（execute 方法）將事務(wù)邏輯與業(yè)務(wù)邏輯分離，避免手動(dòng)編寫繁瑣的 try-catch-finally 事務(wù)控制代碼。
使用時(shí)可以靈活設(shè)置事務(wù)傳播行為、隔離級(jí)別和超時(shí)時(shí)間，滿足不同業(yè)務(wù)場(chǎng)景的需求。
適合在 無法使用聲明式事務(wù)（@Transactional） 的場(chǎng)景下，或需要對(duì)事務(wù)邊界進(jìn)行更細(xì)粒度控制時(shí)使用。
常見應(yīng)用場(chǎng)景包括：批量操作中部分步驟需要獨(dú)立事務(wù)、跨方法調(diào)用時(shí)避免事務(wù)傳播問題、或在框架/工具類中封裝事務(wù)邏輯。

@Configuration(proxyBeanMethods = false)
	@ConditionalOnBean(TransactionManager.class)
	@ConditionalOnMissingBean(AbstractTransactionManagementConfiguration.class)
	public static class EnableTransactionManagementConfiguration {
		@Configuration(proxyBeanMethods = false)
		@EnableTransactionManagement(proxyTargetClass = false)
		@ConditionalOnBooleanProperty(name = "spring.aop.proxy-target-class", havingValue = false)
		public static class JdkDynamicAutoProxyConfiguration {
		}
		@Configuration(proxyBeanMethods = false)
		@EnableTransactionManagement(proxyTargetClass = true)
		@ConditionalOnBooleanProperty(name = "spring.aop.proxy-target-class", matchIfMissing = true)
		public static class CglibAutoProxyConfiguration {
		}
	}

上面這個(gè)配置類的作用，是為 Spring 的聲明式事務(wù)管理（即使用 @Transactional 注解） 啟用合適的 AOP 代理機(jī)制：

@EnableTransactionManagement 本身就是開啟基于 AOP 的事務(wù)管理的關(guān)鍵注解。
- proxyTargetClass 參數(shù)決定了 Spring 在為 @Transactional 方法生成代理時(shí)，使用 JDK 動(dòng)態(tài)代理（接口代理）還是 CGLIB 子類代理。
- proxyTargetClass = false → 使用 JDK 動(dòng)態(tài)代理（要求目標(biāo)類有接口）。
- proxyTargetClass = true → 使用 CGLIB 代理（通過生成子類實(shí)現(xiàn)代理，適合沒有接口的類）。
這段配置通過 @ConditionalOnBooleanProperty(name = "spring.aop.proxy-target-class", …) 來根據(jù)配置文件中的 spring.aop.proxy-target-class 屬性，自動(dòng)選擇 JDK 或 CGLIB 代理。
因此，它確實(shí)是針對(duì) @Transactional 注解生效時(shí)所依賴的代理機(jī)制 的配置。

使用TransactionTemplate 顯式控制事務(wù)

    @Autowired
    private TransactionOperations transactionTemplate;
    @Override
    public List<String> listDepartmentsByCorpId(String corpId) {
        return transactionTemplate.execute(status -> List.of("dingtalk_dept1", "dingtalk_dept2"));
    }

使用Spring 的聲明式事務(wù)管理（即使用@Transactional注解）

    @Transactional(rollbackFor = Exception.class)
    public List<String> listDepartmentsByCorpId(String corpId) {
        return List.of("dingtalk_dept1", "dingtalk_dept2");
    }

總結(jié)

Spring Boot 通過 TransactionAutoConfiguration 自動(dòng)裝配事務(wù)管理器和 TransactionTemplate，讓開發(fā)者在引入數(shù)據(jù)源依賴后即可開箱即用事務(wù)功能，無需手動(dòng)配置。它同時(shí)啟用基于 @Transactional 的聲明式事務(wù)管理，并根據(jù) spring.aop.proxy-target-class 自動(dòng)選擇 JDK 動(dòng)態(tài)代理或 CGLIB 代理

到此這篇關(guān)于Spring Boot 自動(dòng)配置之 Spring transaction的文章就介紹到這了,更多相關(guān)Spring Boot 自動(dòng)配置Spring transaction內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: