Java 后端 / 系统课时
划分事务边界
划分事务边界
本课解决“事务注解加在哪里才可靠”的问题。你将从业务用例出发,把一组必须同时成功或同时失败的数据库操作放进同一事务,并掌握代理生效条件、默认回滚规则、传播行为和外部调用不应长时间占用事务等关键约束。
学习目标
- 根据业务一致性要求确定事务开始与结束位置
- 说明
@Transactional的代理生效条件和默认回滚规则 - 使用集成测试验证提交、回滚和传播行为
先从业务原子性划边界
事务边界应围绕一个完整业务用例,而不是围绕单个 Repository 方法。以“创建订单并扣减库存”为例,订单写入成功但库存扣减失败会产生不一致,因此两步必须处于同一事务;发送邮件或调用远程支付接口通常不应长时间包在数据库事务中。

合理边界通常位于应用服务或领域服务的公开方法:Controller 只处理协议,Repository 只处理持久化,Service 负责组织一个用例中的多个写操作。事务过小无法保证一致性,事务过大则增加锁持有时间、连接占用和死锁概率。
理解注解何时生效
Spring 常通过代理拦截外部方法调用,在进入目标方法前开启事务,在正常返回时提交,在满足回滚规则的异常抛出时回滚。因此,常见的生效前提包括:对象必须由 Spring 容器管理,调用必须经过代理,通常标注在 public 方法上,并且不能依赖同类内部自调用触发新的事务语义。
默认情况下,RuntimeException 和 Error 会触发回滚,受检异常不会。业务要求任何异常都回滚时,应显式使用 rollbackFor = Exception.class,而不是假设所有异常行为相同。
实现一个清晰的事务用例
下面是项目片段示例,依赖已有的订单、库存实体及 Spring Data JPA Repository。事务放在应用服务的公开方法上,方法内只包含必须原子完成的数据库操作。
package com.example.order;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class OrderApplicationService {
private final OrderRepository orderRepository;
private final InventoryRepository inventoryRepository;
public OrderApplicationService(
OrderRepository orderRepository,
InventoryRepository inventoryRepository
) {
this.orderRepository = orderRepository;
this.inventoryRepository = inventoryRepository;
}
@Transactional
public Long placeOrder(Long productId, int quantity) {
if (quantity <= 0) {
throw new IllegalArgumentException("quantity must be positive");
}
Inventory inventory = inventoryRepository.findByProductIdForUpdate(productId)
.orElseThrow(() -> new IllegalStateException("inventory not found"));
inventory.decrease(quantity);
Order order = Order.pending(productId, quantity);
orderRepository.save(order);
return order.getId();
}
}findByProductIdForUpdate 通常通过悲观锁或等价机制防止并发超卖;具体实现取决于前一课定义的 Repository。若库存不足时 decrease 抛出运行时异常,订单写入和库存变更都会回滚。
避免常见失效方式
同类方法直接调用不会再次经过代理。下面的代码看似让 createInNewTransaction 使用新事务,实际调用发生在当前对象内部,REQUIRES_NEW 不会按预期生效。
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;
@Service
public class WrongOrderService {
public void importOrders() {
createInNewTransaction();
}
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void createInNewTransaction() {
// 同类内部调用绕过事务代理
}
}修复方式是把需要独立事务的方法移动到另一个 Spring Bean,再通过依赖调用;也可以重新评估是否真的需要 REQUIRES_NEW。不要为了“让注解生效”随意注入自身代理,这会增加循环依赖和理解成本。
另一个常见错误是捕获异常后不再抛出。事务拦截器只能根据方法最终是否异常退出决定回滚;如果业务把异常吞掉并正常返回,事务通常会提交。确需转换异常时,应抛出新的运行时异常,并保留原始异常作为 cause。
选择传播与只读属性
REQUIRED 是默认传播行为:当前有事务就加入,没有就新建,适合大多数业务用例。REQUIRES_NEW 会暂停外层事务并开启独立事务,适合必须独立提交的审计或补偿记录,但会额外占用数据库连接,应谨慎使用。
只读查询可以标注 @Transactional(readOnly = true)。它主要向事务管理器和 ORM 提供优化提示,不是数据库层面的绝对写保护;代码仍应通过职责划分避免在只读方法中修改实体。
@Transactional(readOnly = true)
public OrderDetail getOrder(Long orderId) {
return orderRepository.findDetailById(orderId)
.orElseThrow(() -> new IllegalArgumentException("order not found"));
}该片段生效后,查询会在只读事务上下文中执行。验证方式是开启 SQL 与事务日志,确认方法加入只读事务,并确保没有产生 insert、update 或 delete。
用集成测试验证回滚
事务规则不能只凭肉眼判断,应通过集成测试验证数据库最终状态。下面的测试先记录订单数,再触发库存不足异常,最后确认订单数量没有增加。
package com.example.order;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@SpringBootTest
class OrderApplicationServiceTest {
@Autowired
private OrderApplicationService orderApplicationService;
@Autowired
private OrderRepository orderRepository;
@Test
void shouldRollbackWhenInventoryIsInsufficient() {
long before = orderRepository.count();
assertThatThrownBy(() ->
orderApplicationService.placeOrder(1001L, 9999)
).isInstanceOf(IllegalStateException.class);
assertThat(orderRepository.count()).isEqualTo(before);
}
}可执行测试命令如下,实际项目路径使用 <PATH> 替换。
cd <PATH>
./mvnw -Dtest=OrderApplicationServiceTest test预期输出
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS如果测试失败,先确认异常是否为受检异常、调用是否经过代理、测试数据是否真的触发库存不足,以及测试方法本身是否开启了会掩盖提交行为的事务。验证“提交成功”时还应新增正常下单用例,并在独立查询中检查订单和库存同时变化。
控制事务持续时间
数据库事务期间不要执行耗时的 HTTP 调用、文件上传或长时间计算。这些操作会延长锁和连接占用。常见做法是在本地事务内写入业务数据与 Outbox 事件,提交后由异步消费者发送消息或调用外部系统。
事务边界也不是越统一越好。查询与命令可分开,批量任务可按可恢复的业务单元分批提交。划分时始终回答两个问题:哪些数据必须一起成功,以及失败后允许从哪里重试。