SpringBoot3+Druid+MybatisPlus多数据源实战：@DS注解在分布式事务中的高级应用

原创

于 2026-02-05 00:10:20 发布 · 242 阅读

标签

1. 多数据源配置基础与@DS注解原理

在SpringBoot3项目中整合Druid和MybatisPlus实现多数据源支持，首先要理解核心机制。Druid作为高性能的数据库连接池，负责底层连接管理；MybatisPlus的dynamic-datasource模块则提供了数据源路由能力。而@DS注解就是整个多数据源切换的"开关控制器"。

我刚开始用多数据源时，最头疼的就是配置文件。后来发现其实只需要在pom.xml中加入这三个关键依赖：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
    <version>3.5.0</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.4</version>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.4.2</version>
</dependency>

配置文件中数据源的定义也有讲究。我习惯用YAML格式，结构更清晰：

spring:
  datasource:
    dynamic:
      primary: master  # 默认数据源
      strict: false    # 是否严格匹配数据源
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/order_db
          username: root
          password: 123456
          driver-class-name: com.mysql.cj.jdbc.Driver
        product:
          url: jdbc:mysql://localhost:3306/product_db 
          username: root
          password: 123456
          driver-class-name: com.mysql.cj.jdbc.Driver

@DS注解的工作原理其实很简单 - 它基于Spring AOP实现，在方法执行前通过DataSourceContextHolder切换线程绑定的数据源。但要注意它的优先级规则：方法注解 > 类注解 > 接口注解 > 默认数据源。这个顺序我在实际项目中踩过坑，后面会详细说。