在 RuoYi 框架中集成 MySQL + SQL Server 多数据源配置（387）

在企业项目中，使用多个数据源已经成为一种常见需求。RuoYi 框架提供了灵活的多数据源配置，支持通过注解的方式轻松切换数据库。本文将详细介绍在 RuoYi 分离版项目中，如何集成 SQL Server 数据库作为辅助数据源，与 MySQL 主数据源一同配置，实现对 SQL Server 和 MySQL 数据库的无缝访问。

一、添加 SQL Server 驱动依赖

首先，需要在 ruoyi-system 模块的 pom.xml 文件中引入 SQL Server 驱动依赖：

<!-- SQL Server 驱动包 -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>7.4.1.jre8</version>
</dependency>

这一步确保项目能够访问 SQL Server 数据库。驱动版本可以根据项目需要进行调整。

二、配置数据源信息

在 RuoYi 框架的多数据源配置文件 application-druid.yml 中，为 MySQL 和 SQL Server 数据库添加连接信息：

# 数据源配置
spring:
    datasource:
        type: com.alibaba.druid.pool.DruidDataSource
        #driverClassName: com.mysql.cj.jdbc.Driver
        druid:
            # 主数据源（MySQL）
            master:
                url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
                username: root
                password: 123456
            # 从数据源（SQL Server）
            slave:
                # 启用从数据源
                enabled: true
                url: jdbc:sqlserver://192.168.101.6:1433;SelectMethod=cursor;DatabaseName=RuoYi_SqlServer
                username: sa
                password: qwe20211114.
            # 数据源连接池参数
            initialSize: 5
            minIdle: 10
            maxActive: 20
            maxWait: 60000
            connectTimeout: 30000
            socketTimeout: 60000
            timeBetweenEvictionRunsMillis: 60000
            minEvictableIdleTimeMillis: 300000
            maxEvictableIdleTimeMillis: 900000
            # 连接有效性检测
            testWhileIdle: true
            testOnBorrow: false
            testOnReturn: false
            # druid 监控配置
            webStatFilter: 
                enabled: true
            statViewServlet:
                enabled: true
                allow:
                url-pattern: /druid/*
                login-username: ruoyi
                login-password: 123456
            filter:
                stat:
                    enabled: true
                    log-slow-sql: true
                    slow-sql-millis: 1000
                    merge-sql: true
                wall:
                    config:
                        multi-statement-allow: true

在这里，master 是主数据源配置，使用 MySQL，slave 是辅助数据源，使用 SQL Server。设置 enabled: true 启用 SQL Server 数据源，并通过 IP 地址、端口、数据库名称等参数来连接到 SQL Server 实例。

三、调整 `DruidProperties` 配置

为了兼容 SQL Server 数据源配置，还需对 DruidProperties.java 文件进行少量修改，注释掉部分不必要的配置：

@Value(" ${spring.datasource.druid.maxEvictableIdleTimeMillis}") private int maxEvictableIdleTimeMillis; /*@Value("$ {spring.datasource.druid.validationQuery}")
private String validationQuery;*/

@Value("${spring.datasource.druid.testWhileIdle}")
private boolean testWhileIdle;

/**
 * 用于检测连接是否有效的 SQL 语句，一般为简单的查询。
 * 如果 validationQuery 为 null，则 testOnBorrow、testOnReturn 和 testWhileIdle 都不会生效。
 */
/*datasource.setValidationQuery(validationQuery);*/

/** 建议配置为 true，不影响性能，并能保证连接有效性。 */
datasource.setTestWhileIdle(testWhileIdle);

这里注释掉 validationQuery 等配置，确保在不同数据库类型下的兼容性。这些属性通常用于连接池的健康检查和空闲连接检测，而 SQL Server 与 MySQL 在此方面的支持可能存在差异，因此需要根据实际情况配置或注释。

四、在业务代码中使用多数据源

为了在代码中灵活地使用多数据源，可以通过 @DataSource 注解指定数据源。该注解既可以应用在类级别，也可以应用在方法级别，具体方式如下：

1. 在方法上指定数据源

通过在方法上添加 @DataSource(value = DataSourceType.SLAVE) 注解，可以指定该方法使用 SQL Server 数据源。

@DataSource(value = DataSourceType.SLAVE)
public List<SysUser> selectUserList(SysUser user) {
    return userMapper.selectUserList(user);
}

在此示例中，selectUserList 方法被标记为从数据源（SQL Server），即 DataSourceType.SLAVE。

2. 在类上指定数据源

此外，可以在整个类上使用 @DataSource 注解指定数据源。在这种情况下，类中所有方法都将默认使用从数据源（SQL Server）：

@Service
@DataSource(value = DataSourceType.SLAVE)
public class SysUserServiceImpl implements SysUserService {
    // 业务代码
}

通过这种方式，SysUserServiceImpl 类中的所有方法将使用 SQL Server 数据源，不需要在每个方法上单独指定。

总结

以上是 RuoYi 分离版项目中集成 SQL Server 多数据源的完整流程。通过引入 SQL Server 驱动、配置多数据源连接信息、调整连接池参数，并在业务代码中灵活应用 @DataSource 注解，我们可以轻松实现对不同数据库的访问和切换。

此方法在实际项目中具有很高的适用性，能够帮助开发者在多数据源架构中更灵活地管理数据访问。如果你需要在项目中集成其他类型的数据库，也可以参照此方法进行配置。希望本文的讲解能为你的项目开发提供实用的帮助！

开发喵星球