Spring Boot整合Seata的过程详解(AT 模式)

 更新时间:2025年10月10日 11:38:24   作者:一个憨憨coder  
文章介绍了如何在SpringBoot项目中整合Seata框架来管理跨服务、跨数据库的分布式事务,本文结合实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧

在 Spring Boot 项目中整合 Seata(分布式事务框架),可以实现跨服务、跨数据库的分布式事务管理。Seata 提供了多种模式,如 AT、TCC、Saga、XA 等,其中 AT 模式 是最常用的一种,它通过代理数据源和全局事务日志(undo_log)来实现自动回滚。

下面介绍 Spring Boot 整合 Seata(AT 模式)

🧩 前提条件

  • 已安装并启动 Seata Server
  • 数据库支持:MySQL / Oracle / PostgreSQL 等
  • Spring Boot 项目使用 MyBatis / JPA / JDBC
  • 使用 Dubbo 或 Spring Cloud Alibaba 微服务架构

✅ 一:搭建 Seata Server(TC)

1. 下载 Seata Server

前往 Seata GitHub Releases 下载最新版本。

例如:

wget https://github.com/seata/seata/releases/download/v2.0.0/seata-server-2.0.0.zip

2. 配置registry.conf和file.conf

修改 registry.conf(注册中心)

如果你用的是 Nacos 注册中心,配置如下:

registry {
  type = "nacos"
  nacos {
    server-addr = "127.0.0.1:8848"
    namespace = ""
    group = "DEFAULT_GROUP"
  }
}
config {
  type = "nacos"
  nacos {
    server-addr = "127.0.0.1:8848"
    namespace = ""
    group = "SEATA_GROUP"
    data-id = "seataServer.properties"
  }
}

3. 启动 Seata Server

cd seata/bin
./seata-server.sh -p 8091 -m file

注意:Windows 用户执行 seata-server.bat

✅ 二:配置数据库(undo_log 表)

每个参与分布式事务的数据库都需要创建 undo_log 表:

-- MySQL 示例
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;

✅ 三:Spring Boot 项目整合 Seata

1. 添加依赖(Maven)

<!-- Spring Boot Starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- MyBatis Plus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- Seata Starter -->
<dependency>
    <groupId>io.seata</groupId>
    <artifactId>seata-spring-boot-starter</artifactId>
</dependency>
<!-- Nacos Discovery(可选) -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2. 配置 application.yml

server:
  port: 8081
spring:
  application:
    name: order-service
  datasource:
    url: jdbc:mysql://localhost:3306/order_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver
    # 使用 Seata 数据源代理
    type: io.seata.rm.datasource.SeataDataSourceProxy
# Seata 配置
seata:
  enabled: true
  application-id: ${spring.application.name} # 应用唯一ID
  tx-service-group: my_test_tx_group       # 事务组名(与 TC 配置一致)
  service:
    vgroup-mapping:
      my_test_tx_group: default             # 映射事务组到默认集群
    grouplist:
      default: 127.0.0.1:8091               # TC 地址(仅测试环境需要)
  config:
    type: nacos                            # 配置中心类型
    nacos:
      server-addr: 127.0.0.1:8848
      group: SEATA_GROUP
      data-id: seataServer.properties
  registry:
    type: nacos                           # 注册中心类型
    nacos:
      server-addr: 127.0.0.1:8848

3. 编写业务代码

Service 层添加 @GlobalTransactional 注解
import io.seata.spring.annotation.GlobalTransactional;
import org.springframework.stereotype.Service;
@Service
public class OrderService {
    @GlobalTransactional(name = "create-order", rollbackFor = Exception.class)
    public void createOrder() throws Exception {
        // 调用库存服务扣减库存(RPC)
        stockService.decreaseStock();
        // 插入订单
        orderMapper.insert(new Order(...));
        // 模拟异常触发回滚
        if (true) {
            throw new RuntimeException("模拟失败");
        }
    }
}

4. 启动类

@SpringBootApplication
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

✅ 四:多服务协同调用(微服务场景)

  • 所有服务都引入 seata-spring-boot-starter
  • 所有服务都要配置相同的 tx-service-group
  • 在 Feign/RPC 调用时,Seata 会自动传播 XID,实现全局事务控制

✅ 验证是否生效

  1. 查看日志中是否有 xid=xxx 输出
  2. 触发异常后,检查各服务数据库是否回滚
  3. 查看 Seata Server 控制台日志

📌 常见问题排查

问题解决方案
无法连接 TC检查 Seata Server 是否启动,配置的 IP/端口是否正确
未找到 undo_log 表检查数据库是否已创建该表
分布式事务不生效检查是否开启 @GlobalTransactional,是否使用 Seata 数据源代理
多个服务之间 XID 不一致检查 Feign/RPC 是否开启拦截器,或是否遗漏 Seata 配置

✅ 小结

步骤内容
1安装并启动 Seata Server
2创建 undo_log
3引入依赖、配置数据源、添加注解
4多服务协调调用,验证事务一致性

到此这篇关于Spring Boot整合Seata的过程详解(AT 模式)的文章就介绍到这了,更多相关springboot整合seata内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot 如何读取pom.xml中的值

    SpringBoot 如何读取pom.xml中的值

    这篇文章主要介绍了SpringBoot 如何读取pom.xml中的值,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-01-01
  • Mybatis Interceptor 拦截器的实现

    Mybatis Interceptor 拦截器的实现

    这篇文章主要介绍了Mybatis Interceptor 拦截器的实现,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-12-12
  • 详解Java集合中的基本数据结构

    详解Java集合中的基本数据结构

    总有小伙伴让我总结一下Java集合中的基本数据结构的相关知识,今天特地整理了本篇文章,文中有非常详细的介绍,需要的朋友可以参考下
    2021-06-06
  • 浅谈Java面向对象之内部类

    浅谈Java面向对象之内部类

    内部类是一个非常有用的特性但又比较难理解使用的特性,我们从外面看是非常容易理解的,无非就是在一个类的内部在定义一个类。其实使用内部类最大的优点就在于它能够非常好的解决多重继承的问题
    2021-06-06
  • JAVA反射机制实例详解

    JAVA反射机制实例详解

    这篇文章主要介绍了JAVA反射机制,以实例形式较为详细的分析讲解了Java反射机制的具体概念、功能与使用技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-11-11
  • Java基础教程之继承详解

    Java基础教程之继承详解

    这篇文章主要介绍了Java基础教程之继承详解,继承是除组合(composition)之外,提高代码重复可用性(reusibility)的另一种重要方式,本文对继承做了详细讲解,需要的朋友可以参考下
    2014-08-08
  • Java之Set 交集,差集,并集的用法

    Java之Set 交集,差集,并集的用法

    这篇文章主要介绍了Java之Set 交集,差集,并集的用法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • SpringBoot部署和前端连接问题解决的完整指南(net::ERR_CONNECTION_REFUSED)

    SpringBoot部署和前端连接问题解决的完整指南(net::ERR_CONNECTION_REFUSED)

    在开发和部署 Spring Boot 应用时,可能会遇到各种问题,例如 JAR 文件无法运行、前端无法连接后端服务等,本文将详细总结这些问题的解决方法,帮助你顺利部署和运行 Spring Boot 应用,需要的朋友可以参考下
    2025-01-01
  • 详解 问题:HttpServlet cannot be resolved to a type

    详解 问题:HttpServlet cannot be resolved to a type

    这篇文章主要介绍了详解 问题:HttpServlet cannot be resolved to a type的相关资料,需要的朋友可以参考下
    2017-03-03
  • springboot中使用groovy的示例代码

    springboot中使用groovy的示例代码

    Groovy就是一种继承了动态语言的优良特性并运行在JVM上的编程语言,Groovy支持动态输入,闭包,元编程,运算符重载等等语法,这篇文章主要介绍了springboot中使用groovy的相关知识,需要的朋友可以参考下
    2022-09-09

最新评论