分布式事务 Seata：从原理到实战完整指南

原创于 2026-08-04 17:43:19 发布 · 121 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

java基础

1. 引言

在微服务架构中，业务操作往往需要跨多个服务完成，如何保证数据一致性成为关键挑战。分布式事务解决方案 Seata（Simple Extensible Autonomous Transaction Architecture）应运而生。本文将深入剖析 Seata 的核心原理、部署架构，并提供详细的配置示例和代码实战，帮助开发者快速掌握这一重要技术。

2. Seata 核心概念与原理

2.1 分布式事务模式

Seata 支持 AT、TCC、Saga、XA 四种事务模式：

AT 模式（自动补偿）：基于两阶段提交，通过全局锁和反向 SQL 日志实现自动回滚，对业务代码无侵入。
TCC 模式（手动补偿）：Try-Confirm-Cancel 三阶段，需要业务代码实现 try、confirm、cancel 三个接口。
Saga 模式（长事务）：通过状态机编排服务调用，每个服务提供正向操作和补偿操作。
XA 模式：基于数据库 XA 协议，强一致性，但性能开销较大。

2.2 核心组件

Transaction Coordinator (TC)：事务协调器，维护全局事务和分支事务状态。
Transaction Manager (TM)：事务管理器，定义全局事务边界，发起全局提交或回滚。
Resource Manager (RM)：资源管理器，管理分支事务资源，向 TC 注册分支事务并报告状态。

3. 架构设计与部署

3.1 整体架构图

上图展示了 Seata 的整体架构，包含以下核心组件：

Transaction Coordinator (TC)：事务协调器，独立部署，负责维护全局事务和分支事务的状态，协调全局事务的提交或回滚。
Transaction Manager (TM)：事务管理器，嵌入在业务应用中，定义全局事务边界，向 TC 发起全局事务的开启、提交或回滚。
Resource Manager (RM)：资源管理器，同样嵌入在业务应用中，负责管理分支事务资源，向 TC 注册分支事务并报告分支事务状态。

架构流程：TM 向 TC 注册全局事务，RM 向 TC 注册分支事务并上报状态，TC 根据分支事务状态决定全局事务的最终提交或回滚。

Seata 采用 Server-Client 架构，TC 作为独立服务部署，TM 和 RM 以客户端形式嵌入业务应用。

3.2 部署模式

单机模式：适用于开发测试环境。
集群模式：TC 集群部署，支持高可用。
注册中心：支持 Nacos、Eureka、Consul、Zookeeper 等。
配置中心：支持 Nacos、Apollo、Zookeeper、Consul、Etcd3。

4. 环境准备与配置

4.1 依赖配置（Maven）

<!-- Seata 客户端依赖 -->
<dependency>
    <groupId>io.seata</groupId>
    <artifactId>seata-spring-boot-starter</artifactId>
    <version>1.7.1</version>
</dependency>

<!-- 数据库驱动（以 MySQL 为例）-->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

<!-- Spring Boot Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

4.2 Seata Server 配置

# file: seata-server/conf/registry.conf
registry {
  type = "nacos"
  nacos {
    serverAddr = "localhost:8848"
    namespace = ""
    cluster = "default"
  }
}

config {
  type = "nacos"
  nacos {
    serverAddr = "localhost:8848"
    namespace = ""
    group = "SEATA_GROUP"
  }
}

5. 核心代码实现（AT 模式示例）

5.1 全局事务注解

@Service
public class OrderService {
    
    @Autowired
    private OrderMapper orderMapper;
    
    @Autowired
    private AccountService accountService;
    
    @GlobalTransactional(name = "create-order", timeoutMills = 300000)
    public void createOrder(OrderDTO orderDTO) {
        // 1. 创建订单（本地事务）
        orderMapper.insert(orderDTO);
        
        // 2. 扣减库存（远程调用）
        stockService.deduct(orderDTO.getProductId(), orderDTO.getCount());
        
        // 3. 扣减账户余额（远程调用）
        accountService.decrease(orderDTO.getUserId(), orderDTO.getMoney());
        
        // 如果任何一步失败，Seata 会自动回滚前面所有操作
    }
}

5.2 数据源代理配置

@Configuration
public class DataSourceConfig {
    
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DruidDataSource druidDataSource() {
        return new DruidDataSource();
    }
    
    @Primary
    @Bean("dataSource")
    public DataSource dataSource(DruidDataSource druidDataSource) {
        // 关键：对数据源进行 Seata 代理
        return new DataSourceProxy(druidDataSource);
    }
}

5.3 Undo Log 表结构

CREATE TABLE `undo_log` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `branch_id` bigint(20) NOT NULL,
  `xid` varchar(100) NOT NULL,
  `context` varchar(128) NOT NULL,
  `rollback_info` longblob NOT NULL,
  `log_status` int(11) NOT NULL,
  `log_created` datetime NOT NULL,
  `log_modified` datetime NOT NULL,
  `ext` varchar(100) DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

6. 运行结果与验证

6.1 正常流程验证

当所有服务调用成功时，全局事务提交：

2024-01-15 10:30:25.123 INFO  [TM] Begin new global transaction [192.168.1.100:8091:123456789]
2024-01-15 10:30:25.456 INFO  [RM] Register branch successfully, xid=192.168.1.100:8091:123456789, branchId=123457
2024-01-15 10:30:25.789 INFO  [TC] Commit global transaction successfully, xid=192.168.1.100:8091:123456789

6.2 异常回滚验证

当库存不足时，全局事务回滚：

@Service
public class StockService {
    
    @Transactional
    public void deduct(String productId, Integer count) {
        // 模拟库存不足异常
        if (count > getStock(productId)) {
            throw new RuntimeException("库存不足");
        }
        // 扣减库存逻辑...
    }
}

2024-01-15 10:31:15.123 INFO  [TM] Begin new global transaction [192.168.1.100:8091:987654321]
2024-01-15 10:31:15.456 INFO  [RM] Register branch successfully, xid=192.168.1.100:8091:987654321, branchId=123458
2024-01-15 10:31:15.789 ERROR [TC] Rollback global transaction, xid=192.168.1.100:8091:987654321
2024-01-15 10:31:16.123 INFO  [RM] Rollback branch successfully, xid=192.168.1.100:8091:987654321, branchId=123458