Apache Seata 1.8 配置 store.mode=db 不生效问题解析

在使用 Apache Seata 1.8 版本时，开发者可能会遇到一个常见问题：即使配置文件中明确设置了 store.mode=db，系统仍然默认使用 file 模式存储数据。本文将深入分析这一问题的原因，并提供解决方案。

问题现象

当开发者在 Seata 配置文件中设置存储模式为数据库(db)时：

seata:
  store:
    mode: db
    session:
      mode: db
    lock:
      mode: db
    db:
      datasource: druid
      db-type: mysql
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://192.168.20.111:3306/seata?useSSL=false&useUnicode=true&rewriteBatchedStatements=true
      user: root
      password: root

启动后却发现控制台仍然显示：

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

同时，数据库中的相关表（如 lock_table、branch_table 等）也没有数据写入。

问题根源

经过分析，这个问题主要源于配置前缀的使用不当。在 Seata 与 Spring Boot 集成时，配置项的处理有以下特点：

1. 配置前缀处理：当使用 Spring Boot 集成 Seata 时，配置项会自动加上 seata. 前缀。这意味着在 Nacos 等配置中心中，实际配置项不应再包含 seata. 前缀。

2. 配置覆盖机制：Seata 会按照特定顺序加载配置，如果存在多个配置源，可能会发生配置覆盖的情况。

3. 默认值机制：如果配置没有正确加载，Seata 会回退到默认的 file 模式。

解决方案

要解决这个问题，可以采取以下步骤：

1. 检查配置前缀：确保在 Nacos 或其他配置中心中，配置项不包含 seata. 前缀。正确的配置应该是：

store:
  mode: db
  session:
    mode: db
  lock:
    mode: db
  db:
    datasource: druid
    db-type: mysql
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://192.168.20.111:3306/seata?useSSL=false&useUnicode=true&rewriteBatchedStatements=true
    user: root
    password: root

2. 验证配置加载：可以通过以下方式验证配置是否正确加载：

   • 检查启动日志中的配置加载信息
   • 使用 Spring Boot Actuator 的 /env 端点查看最终生效的配置

3. 数据库准备：确保数据库已经正确初始化，包含 Seata 所需的所有表结构。

深入理解

为了更好地理解这个问题，我们需要了解 Seata 的配置加载机制：

1. 多环境配置支持：Seata 支持从多个来源加载配置，包括本地文件、Nacos、Zookeeper 等。

2. 配置优先级：不同来源的配置有不同的优先级，开发者需要了解这些优先级以避免配置冲突。

3. Spring Boot 集成：当与 Spring Boot 集成时，Spring 会自动为配置项添加前缀，这是许多开发者容易忽略的一点。

最佳实践

为了避免类似问题，建议遵循以下最佳实践：

1. 统一配置管理：尽量使用一个统一的配置中心管理所有配置。

2. 配置验证：在应用启动前，验证配置是否正确加载。

3. 日志监控：密切关注启动日志，特别是配置加载相关的信息。

4. 版本兼容性：确保使用的 Seata 版本与 Spring Boot 版本兼容。

通过理解这些原理和遵循最佳实践，开发者可以避免 Seata 存储模式配置不生效的问题，确保分布式事务数据正确持久化到数据库中。