Java 后端 / 系统课时

划分事务边界

划分事务边界

本课解决“事务注解加在哪里才可靠”的问题。你将从业务用例出发,把一组必须同时成功或同时失败的数据库操作放进同一事务,并掌握代理生效条件、默认回滚规则、传播行为和外部调用不应长时间占用事务等关键约束。

学习目标

  • 根据业务一致性要求确定事务开始与结束位置
  • 说明 @Transactional 的代理生效条件和默认回滚规则
  • 使用集成测试验证提交、回滚和传播行为

先从业务原子性划边界

事务边界应围绕一个完整业务用例,而不是围绕单个 Repository 方法。以“创建订单并扣减库存”为例,订单写入成功但库存扣减失败会产生不一致,因此两步必须处于同一事务;发送邮件或调用远程支付接口通常不应长时间包在数据库事务中。

订单创建事务边界与外部调用关系

合理边界通常位于应用服务或领域服务的公开方法:Controller 只处理协议,Repository 只处理持久化,Service 负责组织一个用例中的多个写操作。事务过小无法保证一致性,事务过大则增加锁持有时间、连接占用和死锁概率。

理解注解何时生效

Spring 常通过代理拦截外部方法调用,在进入目标方法前开启事务,在正常返回时提交,在满足回滚规则的异常抛出时回滚。因此,常见的生效前提包括:对象必须由 Spring 容器管理,调用必须经过代理,通常标注在 public 方法上,并且不能依赖同类内部自调用触发新的事务语义。

默认情况下,RuntimeException 和 Error 会触发回滚,受检异常不会。业务要求任何异常都回滚时,应显式使用 rollbackFor = Exception.class,而不是假设所有异常行为相同。

实现一个清晰的事务用例

下面是项目片段示例,依赖已有的订单、库存实体及 Spring Data JPA Repository。事务放在应用服务的公开方法上,方法内只包含必须原子完成的数据库操作。

java
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 不会按预期生效。

java
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 提供优化提示,不是数据库层面的绝对写保护;代码仍应通过职责划分避免在只读方法中修改实体。

java
@Transactional(readOnly = true)
public OrderDetail getOrder(Long orderId) {
    return orderRepository.findDetailById(orderId)
            .orElseThrow(() -> new IllegalArgumentException("order not found"));
}

该片段生效后,查询会在只读事务上下文中执行。验证方式是开启 SQL 与事务日志,确认方法加入只读事务,并确保没有产生 insert、update 或 delete。

用集成测试验证回滚

事务规则不能只凭肉眼判断,应通过集成测试验证数据库最终状态。下面的测试先记录订单数,再触发库存不足异常,最后确认订单数量没有增加。

java
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> 替换。

bash
cd <PATH>
./mvnw -Dtest=OrderApplicationServiceTest test

预期输出

text
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

如果测试失败,先确认异常是否为受检异常、调用是否经过代理、测试数据是否真的触发库存不足,以及测试方法本身是否开启了会掩盖提交行为的事务。验证“提交成功”时还应新增正常下单用例,并在独立查询中检查订单和库存同时变化。

控制事务持续时间

数据库事务期间不要执行耗时的 HTTP 调用、文件上传或长时间计算。这些操作会延长锁和连接占用。常见做法是在本地事务内写入业务数据与 Outbox 事件,提交后由异步消费者发送消息或调用外部系统。

事务边界也不是越统一越好。查询与命令可分开,批量任务可按可恢复的业务单元分批提交。划分时始终回答两个问题:哪些数据必须一起成功,以及失败后允许从哪里重试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

划分事务边界

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通