当前位置：首页 > news >正文

Spring事务传播机制

news 来源：原创 2025/6/9 22:38:49

Spring 事务传播机制定义了在多个事务方法相互调用时，事务如何在这些方法间传播。它决定了一个事务方法调用另一个事务方法时，新的事务是如何开启、是否要加入已有的事务等情况。Spring 提供了 7 种事务传播行为，下面是详细介绍。

解释说明：事务方法：方法上加上事务注解的方法叫事务方法

一. PROPAGATION_REQUIRED（默认）

若当前存在事务，就加入该事务；若不存在事务，就创建一个新事务。这是最常用的传播行为。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.REQUIRED)
public void methodB() {
    // 业务逻辑
}


//解释说明：当methodA调用methodB时，由于methodA开启了事务，methodB会加入到methodA的事务中。

在PROPAGATION_REQUIRED 传播机制下，methodA 和 methodB 属于同一事务，异常处理规则如下：

1.1 运行时异常或 `Error`

若 methodA 或 methodB 抛出运行时异常（ NullPointerException） 或 Error，Spring 事务会默认回滚整个事务。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    methodB(); // methodB 抛运行时异常
}

@Transactional(propagation = Propagation.REQUIRED)
public void methodB() {
    throw new NullPointerException("空指针异常"); // 触发事务回滚
}


//此时，整个事务回滚，methodA 和 methodB 的操作都不会提交到数据库。

1.2 受查异常

若抛出受查（ IOException），且未在 @Transactional 中配置 rollbackFor，Spring 事务不会自动回滚。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    methodB(); // methodB 抛受检异常
}

@Transactional(propagation = Propagation.REQUIRED)
public void methodB() throws IOException {
    throw new IOException("IO 异常"); // 不会自动回滚事务
}

若希望受检异常也触发回滚，需显式配置 rollbackFor：

@Transactional(propagation = Propagation.REQUIRED, rollbackFor = IOException.class)
public void methodB() throws IOException {
    throw new IOException("IO 异常"); // 配置后触发事务回滚
}

`二. PROPAGATION_SUPPORTS`

若当前存在事务，就加入该事务；若不存在事务，就以非事务方式执行。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.SUPPORTS)
public void methodB() {
    // 业务逻辑
}



//解释说明：若methodA有事务，methodB会加入该事务；若methodA没有事务，methodB会以非事务方式执行。

解释说明：

1. 若当前存在事务（如 methodA 开启事务，methodB 加入事务）

运行时异常 / Error：
Spring 事务默认回滚整个事务。例如 methodB 抛出 NullPointerException，methodA 和 methodB 的数据库操作都会回滚。

受检异常（如 IOException）：
若未配置 rollbackFor,事务不会自动回滚，数据库操作正常提交。
若配置 rollbackFor（如 @Transactional(propagation = Propagation.SUPPORTS, rollbackFor = IOException.class),则触发事务回滚。


2. 若当前不存在事务
假设 methodA 没有 @Transactional（即无事务），methodB 以非事务方式执行。
此时异常处理完全是普通代码逻辑：


总结：PROPAGATION_SUPPORTS 的异常处理逻辑,本质由是否处于事务环境决定：
有事务时遵循事务回滚规则,无事务时按普通代码逻辑处理。

三. `PROPAGATION_MANDATORY`

若当前存在事务，就加入该事务；若不存在事务，就抛出异常。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.MANDATORY)
public void methodB() {
    // 业务逻辑
}


//若methodA有事务，methodB会加入该事务;若methodA没有事务,调用methodB时会抛出异常。

四. `PROPAGATION_REQUIRES_NEW`

无论当前是否存在事务，都会创建一个新事务，并且挂起当前事务（如果存在）。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void methodB() {
    // 业务逻辑
}


//当methodA调用methodB时，methodB会创建一个新事务,methodA的事务会被挂起，直到methodB的事务完成。

五. `PROPAGATION_NOT_SUPPORTED`

以非事务方式执行操作，如果当前存在事务，就挂起当前事务。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.NOT_SUPPORTED)
public void methodB() {
    // 业务逻辑
}

//当methodA调用methodB时,methodB会以非事务方式执行,methodA的事务会被挂起。

六. `PROPAGATION_NEVER`

以非事务方式执行，如果当前存在事务，则抛出异常。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.NEVER)
public void methodB() {
    // 业务逻辑
}

//若methodA有事务，调用methodB时会抛出异常。

七. `PROPAGATION_NESTED`

若当前存在事务，则在嵌套事务内执行；若当前不存在事务，则执行与PROPAGATION_REQUIRED类似的操作。嵌套事务是外部事务的子事务，有独立的保存点，子事务的回滚不会影响外部事务，但外部事务回滚会导致子事务回滚。

@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 业务逻辑
    methodB();
}

@Transactional(propagation = Propagation.NESTED)
public void methodB() {
    // 业务逻辑
}

//当methodA调用methodB时,methodB会在methodA的事务内创建一个嵌套事务。