若依(ruoyi)開源系統-多資料來源問題踩坑實錄

2023-10-11 12:02:28

內容概要

上一節內容   介紹了用開源系統若依(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 ]同步更新,歡迎大家關注~