@DS注解方式springboot多数据源配置及失效场景解决

本文介绍了如何在SpringBoot项目中配置动态数据源,包括引入依赖、配置DruidDataSource、MyBatis-Plus设置以及解决使用@DS注解时的事务问题。重点讲解了配置方法和失效场景的解决方案。

1.使用教程

导入依赖

<!--多数据源-->
		<dependency>
			<groupId>com.baomidou</groupId>
			<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
			<version>3.5.0</version>
		</dependency>

配置数据源

  datasource:
    dynamic:
    # 主数据源位master
      primary: master
      strict: false
      datasource:
        master:
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://172.16.5.10:3306/master?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
          username: master
          password: master
          type: com.alibaba.druid.pool.DruidDataSource
          druid:
            initial-size: 20
            min-idle: 20
            max-active: 100
            max-wait: 60000
            pool-prepared-statements: false
            max-pool-prepared-statement-per-connection-size: 20
            timeBetweenEvictionRunsMillis: 60000
            validationQuery: SELECT 1 FROM dual
            filter: stat,wall,log4j
        slave:
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://172.16.5.69:3306/slave?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
          username: slave
          password: slave
          type: com.alibaba.druid.pool.DruidDataSource
          druid:
            initial-size: 20
            min-idle: 20
            max-active: 100
            max-wait: 60000
            pool-prepared-statements: false
            max-pool-prepared-statement-per-connection-size: 20
            timeBetweenEvictionRunsMillis: 60000
            validationQuery: SELECT 1 FROM dual
            filter: stat,wall,log4j

#mybatis-plus
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
    map-underscore-to-camel-case: true
  mapper-locations: classpath*:/mapper/**/*mapper.xml
  type-aliases-package: com.byyl.datacenter.entity
  global-config:
    db-config:
      logic-delete-field: deleted # 全局逻辑删除的实体字段名(since 3.3.0,配置后可以忽略不配置步骤2)
      logic-delete-value: 1 # 逻辑已删除值(默认为 1)
      logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)

使用方式

再service具体实现类或者方法上添加 @DS("slave“) 即可切换数据源【slave为配置文件里配置的数据源名称】
在这里插入图片描述

失效场景解决方案

使用动态数据源(@DS)时,@Transactional使用可能会照成@DS失效。

解决方案:

  • 1.去掉事务(不建议)
  • 2.@DS切换数据源的方法添加事务传播属性@Transactional(propagation = Propagation.REQUIRES_NEW, rollbackFor = Exception.class)
  • 3.去掉@DS切换数据源方法的事务,主方法用@DSTransactional注解。

@DS注解加到mapper接口、service接口、service方法里都不生效

解决方案:

  • 添加到service实现类或者实现类里具体的方法上。

在同一个实现类中,一个非DS注解的常规方法里调用@DS注解的方法可能失效

解决方案:

  • 将该DS注解方法定义在不同的类中,通过bean注入的方式调用
### 配置依赖 在 Spring Boot 项目中实现多数据源切换,需要引入 `dynamic-datasource-spring-boot-starter` 依赖。此依赖提供了动态数据源配置和管理功能,并支持通过 `@DS` 注解实现数据源的动态切换。在 `pom.xml` 文件中添加以下依赖: ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.5.1</version> </dependency> ``` 该依赖提供了对多数据源的支持,并允许通过 `@DS` 注解标记需要使用特定数据源的方法或类 [^3]。 --- ### 配置多数据源 在 `application.yml` 中配置多个数据源,例如 MySQL 和人大金仓(Kingbase)。确保数据源名称、URL、用户名、密码以及驱动类名配置正确: ```yaml spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/master_db?useSSL=false&serverTimezone=UTC username: root password: root driver-class-name: com.mysql.cj.jdbc.Driver kingbase: url: jdbc:kingbase://localhost:5236/kingbase_db username: user password: password driver-class-name: com.kingbase.Driver ``` 其中,`primary` 指定默认数据源,如果没有使用 `@DS` 注解,则会使用主数据源 [^1]。 --- ### 使用 `@DS` 注解切换数据源 在业务代码中,可以通过 `@DS` 注解动态切换数据源。`@DS` 可以注解在方法上或类上,如果同时存在,则遵循就近原则——方法上注解优先于类上注解。例如: ```java import com.baomidou.dynamic.datasource.annotation.DS; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.stereotype.Service; @Service @DS("master") // 类级别注解,指定默认数据源为 master public class DataSourceService { @Autowired private JdbcTemplate jdbcTemplate; public List<Map<String, Object>> queryFromMaster() { return jdbcTemplate.queryForList("SELECT * FROM master_table"); } @DS("kingbase") // 方法级别注解,覆盖类级别注解,指定使用 kingbase 数据源 public List<Map<String, Object>> queryFromKingbase() { return jdbcTemplate.queryForList("SELECT * FROM kingbase_table"); } } ``` 在上述代码中,`queryFromMaster()` 方法默认使用类上注解的 `master` 数据源,而 `queryFromKingbase()` 方法由于注解了 `@DS("kingbase")`,因此会使用 `kingbase` 数据源 [^2]。 --- ### 数据源切换原理 `@DS` 注解的实现基于拦截器机制。拦截器会从方法或类上查找 `@DS` 注解,并获取其值。随后,将数据源名称存储到 `DynamicDataSourceContextHolder` 中,该类使用 `ThreadLocal` 管理当前线程的数据源名称。通过这种方式,确保每个线程使用正确的数据源 [^4]。 --- ### 多数据源配置验证 在启动应用程序后,可以通过日志查看是否成功加载了多数据源配置。日志中应包含多数据源的加载信息,例如: ``` Loaded dynamic data sources: [master, kingbase] ``` 如果日志中未显示相关数据源信息,则说明配置存在问题,需要检查 `application.yml` 文件中的数据源配置是否正确 [^5]。 --- ### 注意事项 1. **数据源名称一致性**:`@DS` 注解的值必须与 `application.yml` 中配置数据源名称一致。 2. **事务管理**:在使用事务时,需注意事务的边界和数据源的绑定,避免因线程复用导致的数据源混乱。 3. **驱动兼容性**:确保数据库驱动版本与数据库版本兼容,例如 MySQL 使用 `mysql-connector-java`,而人大金仓使用 `kingbase-connector-java`。 --- ### 示例代码 ```java import com.baomidou.dynamic.datasource.annotation.DS; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.stereotype.Service; @Service @DS("master") public class UserService { @Autowired private JdbcTemplate jdbcTemplate; public List<Map<String, Object>> getUsersFromMaster() { return jdbcTemplate.queryForList("SELECT * FROM users"); } @DS("kingbase") public List<Map<String, Object>> getUsersFromKingbase() { return jdbcTemplate.queryForList("SELECT * FROM users"); } } ``` 在上述代码中,`getUsersFromMaster()` 方法使用默认的 `master` 数据源,而 `getUsersFromKingbase()` 方法由于注解了 `@DS("kingbase")`,因此会使用 `kingbase` 数据源 。 --- ### 相关问题 1. 如何在 Spring Boot配置多个数据库连接? 2. 如何验证多数据源配置是否生效? 3. 如何解决 `@DS` 注解在事务中失效的问题? 4. 如何在 Spring Boot 中使用 `ThreadLocal` 管理数据源
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值