MybatisPlus 配置多数据源

本文介绍了如何在项目中使用MybatisPlus配置多数据源,以支持Postgresql和Clickhouse。通过引入MybatisPlus和动态数据源的依赖,配置application.yml文件设置数据源信息,然后在服务类或方法上使用@DS注解指定数据源,实现了对不同数据库的操作。测试案例展示了如何在日志相关操作中使用Clickhouse,而其他业务仍然使用Postgresql。

前言

项目之前用的是 Postgresql 数据库,但因为日志相关数据量比较大入库效率很低,而且关于日志相关的数据查询效率也在变慢。所以决定启用 clickhouse,因为 clickhouse 支持大量数据的批量入库,并且查询效率也极高(战斗民族开发的,可想而知,简单粗暴,极致追求效率)。引入 clickhouse 只针对日志相关的数据库,其他业务相关的数据库表依然沿用 Postgresql,所以项目要支持多数据源。

项目原本就是采用的 MybatisPlus,所以在支持多数据源的时候是很简单的。当然,如果原来用的是 Mybatis,要支持多数据源的话,要复杂一些,不过实现起来也是比较容易,这里先介绍 MybatisPlus 支持多数据源配置。

clickhouse 感性趣的,可以看下官方文档,尽量少看一些博客资料,因为版本更新太快了,基本上一个月一版,链接地址:clickhouse 官方文档

配置信息

Jar 包引入
<!--mybatis-plus相关-->
<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
  <version>3.5.2</version>
</dependency>
<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
  <version>3.5.2</version>
</dependency>
<!--postgresql驱动-->
<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>42.5.0</version>
</dependency>
<!--clickhouse驱动-->
<dependency>
  <groupId>ru.yandex.clickhouse</groupId>
  <artifactId>clickhouse-jdbc</artifactId>
  <version>0.3.2</version>
</dependency>
application.yml 配置
spring:
  datasource:
    dynamic:
      primary: master # 默认数据源
      strict: false # 是否严格匹配数据源,false 未匹配到使用默认数据源 true 未匹配到会抛出异常
      datasource:
        master:
          driver-class-name: org.postgresql.Driver
          url: jdbc:postgresql://10.70.70.4:5432/postgres
          username: postgres
          password: postgres
        slave:
          driver-class-name: ru.yandex.clickhouse.ClickHouseDriver
          url: jdbc:clickhouse://10.70.70.4:8123/default

测试案例

我们使用的时候,将注解 @DS("slave") 加在需要操作 clickhouse 数据库的类上面或者方法上。特别注意的是,如果两个地方都添加的话,会优先使用类上面的注解配置。

如果我们想正常操作 Postgresql,什么操作都不用,因为我们配置的 master 默认数据源是 Postgresql

@DS("slave")
@Service
public class LogAuditService extends ServiceImpl<LogAuditMapper, LogAudit> {

    public List<LogAudit> getLogAuditList() {
        return this.list();
    }
    
    @DS("slave")
    public LogAudit getLogAuditById(Long id) {
        return this.getById(id);
    }
}
<think>好的,我现在需要帮助用户解决MyBatis-Plus配置多数据源的问题。首先,我得回想之前用户提到的错误,是关于MybatisPlusAutoConfiguration中sqlSessionTemplate需要单个Bean但找到了多个的情况。用户现在明确问的是多数据源配置,这说明他们可能正在尝试设置多个数据源,但遇到了问题。 首先,我应该先确认用户的需求。配置多数据源通常涉及多个数据库连接,比如主库和从库,或者不同的业务数据库。用户可能是在开发需要访问多个数据库的应用,所以需要分别配置不同的数据源,并让MyBatis-Plus正确识别和使用它们。 接下来,我需要回忆MyBatis-Plus多数据源配置上的常见做法。通常,多数据源配置需要禁用自动配置,然后手动定义每个数据源、SqlSessionFactory和SqlSessionTemplate,并为每个Mapper指定使用的数据源。此外,事务管理也需要特别处理,可能需要为每个数据源配置不同的事务管理器。 然后,我需要考虑用户可能的错误场景。比如,是否在配置多个数据源时没有排除自动配置,导致Spring尝试自动配置,从而产生冲突。或者是否在定义Bean时没有正确使用@Primary注解,导致Spring无法决定使用哪个Bean。 此外,用户可能遇到的问题还包括事务管理不正确,导致跨数据源的事务问题,或者Mapper扫描路径配置错误,导致某些Mapper没有被正确关联到对应的数据源。 接下来,我需要整理出一个清晰的步骤,帮助用户逐步配置多数据源。首先排除自动配置类,然后定义每个数据源,接着为每个数据源创建SqlSessionFactory和SqlSessionTemplate,配置事务管理器,最后在Mapper接口上使用注解指定数据源。 同时,要注意可能的依赖冲突,比如是否同时引入了MyBatisMyBatis-Plus的依赖,导致版本不一致或自动配置冲突。需要提醒用户检查依赖,确保只使用MyBatis-Plus的starter,并排除可能的冲突依赖。 另外,需要给出示例代码,帮助用户更直观地理解配置方式。比如,主数据源和次数据源的配置类,如何设置不同的数据源属性,如何创建对应的SqlSessionFactory和事务管理器。 还要提到动态数据源的场景,如果用户需要更灵活的路由,可能需要引入AbstractRoutingDataSource,但这是一个进阶话题,可以在基本配置之后提及,供用户参考。 最后,总结常见问题和注意事项,比如避免自动配置冲突、正确使用注解、事务管理以及依赖检查,确保用户在实际操作中能够避免常见的陷阱。</think>--- 在 Spring Boot 中配置 MyBatis-Plus 多数据源的核心思路是:**手动定义多个数据源、`SqlSessionFactory` 和 `SqlSessionTemplate`,并通过注解动态切换数据源**。以下是详细步骤和示例代码。 --- ### **1. 排除自动配置** 在启动类中排除 MyBatis-Plus 的自动配置类: ```java @SpringBootApplication(exclude = {MybatisPlusAutoConfiguration.class}) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- ### **2. 配置多个数据源** 在 `application.yml` 中定义多个数据源: ```yaml spring: datasource: primary: url: jdbc:mysql://localhost:3306/db1 username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver secondary: url: jdbc:mysql://localhost:3306/db2 username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver ``` --- ### **3. 手动配置数据源 Bean** 创建配置类定义两个数据源,并标记主数据源: ```java @Configuration public class DataSourceConfig { // 主数据源 @Bean(name = "primaryDataSource") @Primary // 标记为主数据源 @ConfigurationProperties(prefix = "spring.datasource.primary") public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); } // 次数据源 @Bean(name = "secondaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.secondary") public DataSource secondaryDataSource() { return DataSourceBuilder.create().build(); } } ``` --- ### **4. 配置 SqlSessionFactory 和 SqlSessionTemplate** 为每个数据源单独配置 `SqlSessionFactory` 和 `SqlSessionTemplate`: ```java @Configuration @MapperScan( basePackages = "com.example.mapper.primary", // 主数据源的 Mapper 包路径 sqlSessionTemplateRef = "primarySqlSessionTemplate" ) public class PrimaryDataSourceConfig { @Bean @Primary public SqlSessionFactory primarySqlSessionFactory( @Qualifier("primaryDataSource") DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); // 可选:配置其他 MyBatis 属性 factory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath:mapper/primary/*.xml")); return factory.getObject(); } @Bean @Primary public SqlSessionTemplate primarySqlSessionTemplate( @Qualifier("primarySqlSessionFactory") SqlSessionFactory sqlSessionFactory) { return new SqlSessionTemplate(sqlSessionFactory); } } // 类似地,为次数据源创建配置类 SecondaryDataSourceConfig ``` --- ### **5. 配置事务管理器** 为每个数据源配置独立的事务管理器: ```java @Configuration public class TransactionConfig { @Bean @Primary public PlatformTransactionManager primaryTransactionManager( @Qualifier("primaryDataSource") DataSource dataSource) { return new DataSourceTransactionManager(dataSource); } @Bean public PlatformTransactionManager secondaryTransactionManager( @Qualifier("secondaryDataSource") DataSource dataSource) { return new DataSourceTransactionManager(dataSource); } } ``` --- ### **6. 在 Mapper 中指定数据源** 通过 `@DS` 注解(MyBatis-Plus 提供)动态切换数据源: ```java // 主数据源的 Mapper @Repository @DS("primary") // 指定使用主数据源 public interface UserMapper extends BaseMapper<User> { } // 次数据源的 Mapper @Repository @DS("secondary") // 指定使用次数据源 public interface OrderMapper extends BaseMapper<Order> { } ``` --- ### **7. 动态数据源进阶(可选)** 如果需要更灵活的路由(例如根据请求参数切换数据源),可以使用 `AbstractRoutingDataSource`: ```java public class DynamicDataSource extends AbstractRoutingDataSource { @Override protected Object determineCurrentLookupKey() { return DataSourceContextHolder.getDataSourceType(); } } // 通过 ThreadLocal 保存当前数据源标识 public class DataSourceContextHolder { private static final ThreadLocal<String> CONTEXT = new ThreadLocal<>(); public static void setDataSourceType(String type) { CONTEXT.set(type); } public static String getDataSourceType() { return CONTEXT.get(); } public static void clear() { CONTEXT.remove(); } } ``` --- ### **注意事项** 1. **避免自动配置冲突** 确保排除 `MybatisPlusAutoConfiguration`,防止自动配置生成默认 Bean。 2. **明确 Bean 名称** 使用 `@Qualifier` 注解明确指定注入的 Bean。 3. **事务管理** 跨数据源操作时,需使用分布式事务(如 Seata)或避免跨库事务。 4. **依赖检查** 确保依赖中只包含 `mybatis-plus-boot-starter`,排除冲突的 MyBatis 依赖。 --- 通过以上步骤,即可实现 MyBatis-Plus 多数据源配置。如果有更复杂的场景(如读写分离),可结合中间件(如 ShardingSphere)进一步优化。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值