526互联

若依(ruoyi)开源系统-多数据源问题踩坑实录

发布时间 2023-10-11 10:42:28作者: 敬YES

内容概要

上一节内容   介绍了用开源系统若依(ruoyi)搭建页面的过程。在实际项目中，经常遇到多数据源后者主从库的情况。本节记录若依多数据源配置过程中遇到的问题排查过程。

背景描述

1.上一节在ry-vue库中新建了表t_user，这次新建数据库jingyes，新加同样的表t_user。其他功能不变，我们将t_user数据源由ry-vue切换到jingyes库，实现简单的多数据源场景。

CREATE TABLE `t_user` (
  `id` bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `name` varchar(30) NOT NULL DEFAULT '' COMMENT '姓名',
  `age` int(11) NULL DEFAULT NULL COMMENT '年龄',
  `gender` tinyint(2) NOT NULL DEFAULT 0 COMMENT '性别，0：女 1：男',
  PRIMARY KEY (`id`)
) COMMENT = '用户表';

若依多数据源配置

官网教程操作若依多数据源配置 
http://doc.ruoyi.vip/ruoyi/document/htsc.html#多数据源使用

  1. application-druid.yml 新增数据源配置
spring:
    datasource:
            jingyes:
                url: jdbc:mysql://localhost:13306/jingyes?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
                username: root
                password: 123456
  1. 扩展DataSourceType枚举，新增数据源JINGYES
public enum DataSourceType
{
    /**
     * 主库
     */
    MASTER,

    /**
     * 从库
     */
    SLAVE,

    JINGYES;
}
  1. 在目标方法设置注解 @DataSource
    @Override
    @DataSource(value = DataSourceType.JINGYES)
    public List<TUser> selectTUserList(TUser tUser)
    {
        return tUserMapper.selectTUserList(tUser);
    }
  1. 调整DruidConfig，新增数据源配置
     @Bean
 @ConfigurationProperties("spring.datasource.druid.jingyes")
 @ConditionalOnProperty(prefix = "spring.datasource.druid.jingyes", name = "enabled", havingValue = "true")
 public DataSource jingyesDataSource(DruidProperties druidProperties)
 {
     DruidDataSource dataSource = DruidDataSourceBuilder.create().build();
     return druidProperties.dataSource(dataSource);
 }

 @Bean(name = "dynamicDataSource")
 @Primary
 public DynamicDataSource dataSource(DataSource masterDataSource)
 {
     Map<Object, Object> targetDataSources = new HashMap<>();
     targetDataSources.put(DataSourceType.MASTER.name(), masterDataSource);
     setDataSource(targetDataSources, DataSourceType.SLAVE.name(), "slaveDataSource");
     //这里新增自定义数据源
     setDataSource(targetDataSources, DataSourceType.JINGYES.name(), "jingyesDataSource");
     return new DynamicDataSource(masterDataSource, targetDataSources);
 }
  2. 重启服务端项目
    发现点击上一节创建的“外包用户管理”，显示“切换到JINGYES数据源”，然后实际上访问的仍然上MASTER数据源，也就是ry-vue库。（jingyes.t_user表目前还没有数据）

三、调试排查

跟踪调试一下，发现个问题，这里的targetDataSources居然只有Master，那put进去的其他两条呢？

终于被我找到了个若依的坑：这里的异常被吃掉了！！

暂时先打印下异常日志，看下到底什么情况，感觉快找到问题了。

上面命名定义了bean了，为什么会没有呢？返回去看看

    @Bean
    @ConfigurationProperties("spring.datasource.druid.slave")
    @ConditionalOnProperty(prefix = "spring.datasource.druid.slave", name = "enabled", havingValue = "true")
    public DataSource slaveDataSource(DruidProperties druidProperties)
    {
        DruidDataSource dataSource = DruidDataSourceBuilder.create().build();
        return druidProperties.dataSource(dataSource);
    }

原来是属性中enabled的原因，恍然大悟啊。

四、解决方案

最终解决的方式很简单，把application-druid.yml中jingyes数据源新增enabled=true。

spring:
    datasource:
            jingyes:
		        enabled: true #看这里！！
                url: jdbc:mysql://localhost:13306/jingyes?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
                username: root
                password: 123456

重启服务端项目，再调试一下，发现可以取到正确的数据源了。

补充一点，@DataSource除了放在Service层，直接放在Mapper接口也是可以的。

    @DataSource(value = DataSourceType.JINGYES)
    public List<TUser> selectTUserList(TUser tUser);

本人公众号[ 敬YES ]同步更新，欢迎大家关注~

img