若依(ruoyi)開源系統-多數據源問題踩坑實錄

內容概要

上一節內容   介紹了用開源系統若依(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

2. 擴展DataSourceType枚舉，新增數據源JINGYES

public enum DataSourceType
{
    /**
     * 主庫
     */
    MASTER,

    /**
     * 從庫
     */
    SLAVE,

    JINGYES;
}

3. 在目標方法設置註解 @DataSource

    @Override
    @DataSource(value = DataSourceType.JINGYES)
    public List<TUser> selectTUserList(TUser tUser)
    {
        return tUserMapper.selectTUserList(tUser);
    }

4. 調整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);
    }
   

5. 重啓服務端項目
   發現點擊上一節創建的“外包用戶管理”，顯示“切換到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 ]同步更新，歡迎大家關注~