微服务踩坑实录: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 模式。
原因分析:
- 格式混用:我们最初的配置内容是完全正确的(标准的
key=value纯键值对),但在 Nacos 控制台新建配置时,配置格式(Format)下拉框选择了TEXT。Seata Server 2.x 对配置解析非常严格,混用会导致解析失败,静默回退到file模式。 - 前缀错误:在 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 驱动包
-
下载 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 -
找到 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 的配置虽然比老版本更严谨,但也增加了初学者的心智负担。排障的核心思路是:
- 看日志:如果模式是
file,查 Nacos 配置和本地映射;如果抛异常,看具体的 Exception 包名。 - 核对环境:尤其注意 Seata 2.x 去掉了驱动内置,一定要手动放入
lib/jdbc。 - 格式规范:Nacos 配置一定要用原生的 Properties,不要混用 YAML。

浙公网安备 33010602011771号