微服务踩坑实录:Seata 2.5.0 开启 DB 存储模式的连环坑与终极解决指南

📌 背景环境

  • JDK 版本:17
  • Seata Server:2.5.0 (Windows 环境)
  • 配置中心:Nacos
  • 注册中心:Nacos
  • 数据库:MySQL 8.x

在搭建微服务分布式事务环境时,遇到了典型的“事务回滚成功,但 global_table 里没有任何记录”的问题。在排查过程中,又接连踩中了 Nacos 配置格式混乱、Seata 找不到 JDBC 驱动导致闪退 等多个深坑。

本文完整记录了排错的全过程与最终的完美配置方案,希望能帮到同样在折腾 Seata 的开发者。


💥 一:全局事务触发了,但 global_table 毫无记录?

现象:服务成功注册到了 Seata,业务代码中 @GlobalTransactional 也生效了,异常成功触发回滚,但去数据库查 global_table,居然没有任何数据。

原因分析:
查看 Seata Server 的启动日志,发现了这样两行关键信息:

use lock store mode: file`
`use session store mode: file

这说明 Seata Server 运行在默认的 file 存储模式下!它将全局事务的会话数据写入了本地文件(一般在 sessionStore 文件夹下),自然不会在 MySQL 数据库中产生记录。
导致这个问题根本原因,是我们在 Nacos 中的配置没有被 Seata 成功识别。


💥 二:Nacos 配置格式混乱,导致读取失败

现象:明明在 Nacos 中写了非常完整的 DB 配置,内容格式也没错,但 Seata 启动时依然显示 file 模式。

原因分析:

  1. 格式混用:我们最初的配置内容是完全正确的(标准的 key=value 纯键值对),但在 Nacos 控制台新建配置时,配置格式(Format)下拉框选择了 TEXT。Seata Server 2.x 对配置解析非常严格,混用会导致解析失败,静默回退到 file 模式。
  2. 前缀错误:在 Nacos 中配置时,属性名千万不要加 seata. 前缀,Seata 在读取时会自动拼装前缀,加了反而找不到。

正确的 Nacos 配置规范:

  • Data ID:可以任意写,也可以是 seataServer.properties。
  • Group:SEATA_GROUP(与本地 application.yml 对应)。
  • 配置格式:必须选择 Properties(千万不能选 TEXT 或 YAML)。
  • 配置内容:纯键值对,不带任何层级缩进。

💥 三:启动直接闪退,报错找不到 JDBC 驱动

现象:按照上述规范修改 Nacos 后,Seata 启动确实变成了 use lock store mode: db,但紧接着直接抛异常闪退。

报错日志:

Caused by: org.apache.seata.common.exception.StoreException: The driver {com.mysql.cj.jdbc.Driver} cannot be found in the path C:\apps\seata\seata-server\lib\jdbc. Please ensure that the appropriate database driver dependencies are included in the classpath.

原因分析:
这是因为 从 Seata 2.x 版本开始,官方压缩包中不再内置 MySQL 的 JDBC 驱动。由于 MySQL Connector/J 的 GPL 协议与 Seata 的 Apache 2.0 协议存在兼容问题,官方要求用户根据自己使用的数据库版本手动引入驱动。并且 Seata 2.x 默认会去 lib/jdbc 目录下动态加载驱动。


🛠️ 终极解决方案(Step by Step)

经过一系列的踩坑,总结出以下一套完美运行的配置流程:

第一步:补齐 JDBC 驱动包

  1. 下载 MySQL 驱动包,推荐使用 mysql-connector-j-8.0.11.jar 或 8.0.33.jar。(注:在 JDK 17 环境下,实测 8.0.11 版本兼容性最好,高版本可能遇到序列化异常)。

    可以从 Maven Central 下载:

    https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.0.33/mysql-connector-j-8.0.33.jar

  2. 找到 Seata 安装目录,将驱动包放入 lib 目录下的 jdbc 文件夹中:
    路径:C:\apps\seata\seata-server\lib\jdbc\
    (注:如果没有 jdbc 文件夹,请手动新建一个)

第二步:清理并重新配置 Nacos

在 Nacos 控制台中,创建(或修改)一个纯 Properties 格式的配置:

  • Data ID:seataServer.properties
  • Group:SEATA_GROUP
  • 配置内容:
# ===== 1. 事务会话存储模式 (必须设置为 db) =====
store.mode=db
store.session.mode=db
store.lock.mode=db

# ===== 2. 数据库连接配置 =====
store.db.datasource=druid
store.db.dbType=mysql
store.db.driverClassName=com.mysql.cj.jdbc.Driver
# 请将 localhost、端口、数据库名换成你自己的
store.db.url=jdbc:mysql://localhost:3306/seata?characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true
store.db.user=username
store.db.password=password

# ===== 3. 数据库表名 (需与 SQL 脚本创建的表名一致) =====
store.db.globalTable=global_table
store.db.branchTable=branch_table
store.db.lockTable=lock_table
store.db.distributedLockTable=distributed_lock

# ===== 4. 连接池参数 (可选,使用默认值即可) =====
store.db.minConn=5
store.db.maxConn=30
store.db.queryLimit=100
store.db.maxWait=5000

第三步:修改 Seata Server 本地配置

打开 conf/application.yml,确保 Seata 能够正确指向 Nacos 中的这个配置:

#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
server:
  port: 8091
spring:
  application:
    name: seata-server
  main:
    web-application-type: none
logging:
  config: classpath:logback-spring.xml
  file:
    path: ${log.home:${user.home}/logs/seata}
  extend:
    logstash-appender:
      # off by default
      enabled: false
      destination: 127.0.0.1:4560
    kafka-appender:
      # off by default
      enabled: false
      bootstrap-servers: 127.0.0.1:9092
      topic: logback_to_logstash
      producer:
        acks: 0
        linger-ms: 1000
        max-block-ms: 0
    metric-appender:
      # off by default
      enabled: false

seata:
  config:
    # 配置中心类型,这里使用 nacos
    # support: nacos, consul, apollo, zk, etcd3
    type: nacos
    nacos:
      server-addr: 127.0.0.1:8848   # 修改为你的 Nacos 地址
      namespace: ""                 # 如果你的 Nacos 没有创建命名空间,保持为空即可。如果有,必须填命名空间的 ID(不是名字)
      group: SEATA_GROUP            # 必须与 Nacos 里的 Group 保持一致
      data-id: seataServer.properties # 必须与 Nacos 里的 Data ID 绝对一致
      # username: nacos               # 如果你的 Nacos 开启了鉴权,请填写账号,未开启随意
      # password: nacos               # 如果你的 Nacos 开启了鉴权,请填写密码,未开启随意
  
  registry:
    # 注册中心类型,这里使用 nacos
    # support: nacos, eureka, redis, zk, consul, etcd3, sofa
    type: nacos
    nacos:
      application: seata-server
      server-addr: 127.0.0.1:8848   # 修改为你的 Nacos 地址
      group: SEATA_GROUP            # 必须与 Nacos 里的 Group 保持一致
      namespace: ""                 # 与上面的命名空间保持一致
      cluster: default              # 集群名称,默认 default
      # username: nacos               
      # password: nacos               

(注意:本地配置中不需要再重复写 seata.store.\*,统一由 Nacos 下发管理即可)

第四步:重启验证

重新双击 seata-server.bat 启动。如果没有闪退,且在日志中看到了以下关键信息,恭喜你,大功告成!

... use lock store mode: db
... use session store mode: db
... seata server started in 5542 millSeconds

此时,你去微服务中触发一次全局事务回滚,再查 seata 库的 global_table,就能看到真实的事务记录写入数据库了。


💡 总结

Seata 2.x 的配置虽然比老版本更严谨,但也增加了初学者的心智负担。排障的核心思路是:

  1. 看日志:如果模式是 file,查 Nacos 配置和本地映射;如果抛异常,看具体的 Exception 包名。
  2. 核对环境:尤其注意 Seata 2.x 去掉了驱动内置,一定要手动放入 lib/jdbc。
  3. 格式规范:Nacos 配置一定要用原生的 Properties,不要混用 YAML。
posted @ 2026-10-23 13:27  小张睡不醒~  阅读(70)  评论(0)    收藏  举报