SpringBoot - @Transactional注解详解

最新推荐文章于 2025-10-07 17:01:24 发布

原创最新推荐文章于 2025-10-07 17:01:24 发布 · 3.7k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

SpringBoot 专栏收录该内容

108 篇文章

订阅专栏

@Transactional注解提供了事务管理功能，可以在类或方法级别应用。它基于动态代理，支持编程式和声明式事务。默认情况下，仅在遇到运行时异常时回滚事务，但可以通过rollbackFor属性配置。事务传播机制包括REQUIRED、REQUIRES_NEW等，隔离级别有READ_UNCOMMITTED到SERIALIZABLE。文章还讨论了不同场景下的事务回滚情况。

简介

Spring中的@Transactional注解，基于动态代理的机制，提供了一种透明的事务管理机制，方便快捷的解决在开发中碰到的问题，@Transactional 的事务开启，或者是基于接口的或者是基于类的代理被创建。Spring为了更好的支撑数据库操作，在框架中支持了两种事务管理的方式：编程式事务和声明式事务，能够保证作单个逻辑工作单元执行的一系列操作，要么同时成功，要么同时失败。

如何使用

（1）可以作用在类和方法上。
（2）建议不要作用在接口或接口的方法上，因为只有使用基于接口的代理时注解才有效。建议作用在实现类的方法上。
（3）当作用在类上时，该类的PUBLIC方法都具有该类型是事务属性，但是使用作用在方法上的注解来覆盖类级别的定义。
（4）方法的访问权限为PUBLIC。
（5）@Transactional(rollbackFor=Exception.class)，如果方法上加了这个注解，那么当这个方法抛出异常时（运行时和非运行时）就会回滚，数据库里面的数据也会回滚。如果不配置rollbackFor属性，那么事物只会在遇到运行时异常才会回滚。
（6）默认情况下，SPRING只有在抛出的异常为运行时且为unchecked 异常才会回滚事务，也就是抛出的异常为RuntimeException 的子类(Errors也会)时才会回滚事务，而抛出 checked 异常则不会回滚事务，当然可以通过 @Transactional rollbackFor进行配置。

（6.1）checked异常：一般是指程序不能直接控制的外界情况，是指在编译的时候就需要检查的一类异常，用户程序中必须采用try-catch机制处理或者通过throws交由调用者来处理。这类异常主要是指除了Error以及RuntimeException及其子类之外的异常。
（6.2）unchecked异常：一般是那些不在编译的时就要处理的一类异常。在JAVA体系里，所有的Error以及RuntimeException及其子类都是unchecked异常。
在这里插入图片描述

1. 源码定义

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Transactional {

	// 可选的限定描述符，指定使用的事务管理器
	@AliasFor("transactionManager")
	String value() default "";

	@AliasFor("value")
	String transactionManager() default "";

	String[] label() default {};

	// 可选的事务传播机制
	Propagation propagation() default Propagation.REQUIRED;

	// 可选的事务隔离级别
	Isolation isolation() default Isolation.DEFAULT;

	// 事务超时时间设置
	int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;

	String timeoutString() default "";

	boolean readOnly() default false;

	// 导致事务回滚的异常类
	Class<? extends Throwable>[] rollbackFor() default {};

    // 导致事务回滚的异常类名称
	String[] rollbackForClassName() default {};
	
	// 不会导致事务回滚的异常类
	Class<? extends Throwable>[] noRollbackFor() default {};

    // 不会导致事务回滚的异常类名称
	String[] noRollbackForClassName() default {};

}

2. 传播机制

序号	机制名称	描述
1	REQUIRED	默认值，如果当前存在事务，则加入该事务，如果当前没有事务，则创建一个新的事务。
2	REQUIRES_NEW	首先创建一个新的事务，如果当前存在事务，则把当前事务挂起。
3	SUPPORTS	如果当前存在事务，则加入该事务；如果当前没有事务，则以非事务的方式继续运行。
4	NOT_SUPPORTED	以非事务方式运行，如果当前存在事务，则把当前事务挂起。
5	NEVER	以非事务方式运行，如果当前存在事务，则抛出异常。
6	MANDATORY	如果当前存在事务，则加入该事务；如果当前没有事务，则抛出异常。
7	NESTED	如果当前存在事务，则创建一个事务作为当前事务的嵌套事务来运行；如果当前没有事务，则该取值等价于TransactionDefinition.PROPAGATION_REQUIRED。

3. 隔离级别

序号	名称	描述
1	DEFAULT	使用后端数据库默认的隔离级别
2	READ_UNCOMMITTED	读取未提交数据(会出现脏读，不可重复读)
3	READ_COMMITTED	读取已提交数据(会出现不可重复读和幻读)
4	REPEATABLE_READ	可重复读(会出现幻读)
5	SERIALIZABLE	串行化

使用场景

1. 同一个类

场景1

同一类中有A和B两个方法，A方法上没有@Transactional注解，B方法上有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作都不会回滚。


public void a() {
	b();
}
@Transactional(rollbackFor = Exception.class)
public void b() {
}

场景2

同一类中有A和B两个方法，A方法上有@Transactional注解，B方法上没有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
public void a() {
	b();
}
public void b() {
}

场景3

同一类中有A和B两个方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
public void a() {
	b();
}
@Transactional(rollbackFor = Exception.class)
public void b() {
}

2. 不同的类

场景1

类1中有A方法，类2中有B方法，A方法上有@Transactional注解，B方法上没有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
public void a() {
	b();
}
public void b() {
}

场景2

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
public void a() {
	b();
}
@Transactional(rollbackFor = Exception.class)
public void b() {
}

场景3

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，但是A方法捕获了异常，此时B方法操作回滚，A方法抛出异常。

@Transactional(rollbackFor = Exception.class)
public void a() {
	try {
	    b();
    } catch (Exception e) {
        e.printStackTrace();
    }
}
@Transactional(rollbackFor = Exception.class)
public void b() {
}

场景4

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，但是A方法捕获了异常，此时B方法操作回滚，A方法操作成功。

@Transactional(rollbackFor = Exception.class)
public void a() {
	try {
	    b();
    } catch (Exception e) {
        e.printStackTrace();
    }
}
@Transactional(propagation = Propagation.REQUIRES_NEW, rollbackFor = Exception.class)
public void b() {
}