SpringBoot多数据源配置与MyBatisPlus实战

1. 多数据源应用场景与方案选型

在企业级应用开发中，多数据源连接是常见需求。我最近在一个宠物电商平台项目中就遇到了这样的场景：需要同时操作MySQL主从库进行读写分离，还要连接SQL Server处理历史订单数据。经过技术调研，最终选择了SpringBoot+MyBatisPlus+dynamic-datasource的方案组合。

为什么选择这个技术栈？首先，MyBatisPlus是国内Java开发者最熟悉的ORM框架之一，它基于MyBatis进行了功能增强，提供了通用的CRUD操作。而dynamic-datasource是MyBatisPlus官方推荐的多数据源组件，具有以下优势：

1. 注解驱动：通过@DS注解即可切换数据源，无需手动获取连接
2. 轻量级：不依赖Spring原生事务管理，性能损耗小
3. 功能完善：支持主从分离、多租户、动态增减数据源等场景
4. 兼容性强：完美适配MyBatisPlus的各种特性

提示：对于简单的多数据源需求，也可以考虑Spring自带的AbstractRoutingDataSource方案。但dynamic-datasource在功能完整性和易用性上更胜一筹。

2. 环境准备与数据库配置

2.1 数据库环境搭建

根据项目需求，我们需要准备以下数据库环境：

1. MySQL 5.7.44主库（192.168.3.220）
2. MySQL 5.7.44从库（192.168.88.170）
3. SQL Server 2012本地实例

创建测试数据库的SQL脚本如下：

sql复制-- MySQL主库
CREATE DATABASE `jialiangkj-pet` DEFAULT CHARACTER SET utf8mb4;
USE `jialiangkj-pet`;
CREATE TABLE `test` (
  `id` int(11) NOT NULL,
  `name` varchar(20) DEFAULT NULL,
  `remark` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO `test` VALUES (1, '哈士奇', '这是一个正式库');

-- MySQL从库 
CREATE DATABASE `jialiangkj-pet-test` DEFAULT CHARACTER SET utf8mb4;
USE `jialiangkj-pet-test`;
CREATE TABLE `test` (
  `id` int(11) NOT NULL,
  `name` varchar(20) DEFAULT NULL,
  `remark` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO `test` VALUES (1, '边牧', '这是一个测试库');

-- SQL Server
CREATE DATABASE test;
GO
USE test;
GO
CREATE TABLE test.dbo.test (
    id int NOT NULL PRIMARY KEY,
    name varchar(20) NULL,
    remark varchar(50) NULL
);
INSERT INTO test.dbo.test VALUES (1, '柯基', '这是sqlserver数据库');

2.2 开发环境要求

确保本地开发环境满足以下条件：

• JDK 1.8+
• Maven 3.6+
• IntelliJ IDEA（推荐2023.3+版本）
• 数据库连接工具（如Navicat、DBeaver）

3. 项目配置与依赖管理

3.1 Maven依赖配置

在父pom.xml中定义版本管理：

xml复制<properties>
    <dynamic-ds.version>3.5.2</dynamic-ds.version>
    <mybatis-plus.version>3.5.4</mybatis-plus.version>
    <mysql.version>8.0.33</mysql.version>
    <sqlserver.version>12.4.2.jre8</sqlserver.version>
</properties>

<dependencyManagement>
    <dependencies>
        <!-- 多数据源核心 -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
            <version>${dynamic-ds.version}</version>
        </dependency>
        
        <!-- MyBatisPlus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>${mybatis-plus.version}</version>
        </dependency>
        
        <!-- 数据库驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql.version}</version>
        </dependency>
        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>mssql-jdbc</artifactId>
            <version>${sqlserver.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

在业务模块中添加运行时依赖：

xml复制<dependencies>
    <!-- 多数据源 -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
    </dependency>
    
    <!-- MyBatisPlus -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
    </dependency>
    
    <!-- 数据库驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
    <dependency>
        <groupId>com.microsoft.sqlserver</groupId>
        <artifactId>mssql-jdbc</artifactId>
    </dependency>
</dependencies>

3.2 数据源配置详解

application.yml配置示例：

yaml复制spring:
  datasource:
    type: com.zaxxer.hikari.HikariDataSource
    dynamic:
      primary: master  # 默认数据源
      strict: true     # 严格模式，未匹配数据源时报错
      datasource:
        master:  # 主库
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://192.168.3.220:3306/jialiangkj-pet?useSSL=true&serverTimezone=Asia/Shanghai
          username: root
          password: lvdamaoluguo
        slave:   # 从库
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://192.168.88.170:3306/jialiangkj-pet-test?useSSL=true&serverTimezone=Asia/Shanghai
          username: root
          password: lvdamaoluguo
        sqlserver:  # SQL Server
          driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
          url: jdbc:sqlserver://localhost:1433;DatabaseName=test
          username: sa
          password: lvdamaoluguo
      hikari:
        maxPoolSize: 20
        minIdle: 10
        connectionTimeout: 30000

注意：生产环境密码应该使用加密配置，推荐使用Jasypt等工具进行加密处理

4. 核心代码实现

4.1 实体类与Mapper

使用MyBatisX插件自动生成基础代码：

java复制@Data
@TableName("test")
public class TestEntity {
    @TableId(type = IdType.AUTO)
    private Integer id;
    private String name;
    private String remark;
}

public interface TestMapper extends BaseMapper<TestEntity> {
}

4.2 Service层实现

java复制public interface TestService extends IService<TestEntity> {
    TestEntity getFromMaster();
    TestEntity getFromSlave();
    TestEntity getFromSqlServer();
}

@Service
public class TestServiceImpl extends ServiceImpl<TestMapper, TestEntity> 
    implements TestService {
    
    @DS("master")
    public TestEntity getFromMaster() {
        return getById(1);
    }
    
    @DS("slave") 
    public TestEntity getFromSlave() {
        return getById(1);
    }
    
    @DS("sqlserver")
    public TestEntity getFromSqlServer() {
        return getById(1);
    }
}

4.3 Controller层调用

java复制@RestController
@RequestMapping("/test")
public class TestController {
    
    @Autowired
    private TestService testService;
    
    @GetMapping("/master")
    public TestEntity master() {
        return testService.getFromMaster();
    }
    
    @GetMapping("/slave")
    public TestEntity slave() {
        return testService.getFromSlave();
    }
    
    @GetMapping("/sqlserver")
    public TestEntity sqlserver() {
        return testService.getFromSqlServer();
    }
}

5. 高级特性与最佳实践

5.1 事务管理策略

多数据源环境下的事务管理需要特别注意：

1. 默认情况下，@Transactional注解只对默认数据源生效
2. 跨数据源事务需要使用分布式事务方案（如Seata）
3. 单数据源事务建议在Service方法上添加@DS和@Transactional注解

java复制@DS("master")
@Transactional
public void updateMaster(TestEntity entity) {
    updateById(entity);
}

5.2 动态数据源切换

除了注解方式，还可以编程式切换数据源：

java复制DynamicDataSourceContextHolder.push("slave");
try {
    // 执行从库操作
    return testService.getFromSlave();
} finally {
    DynamicDataSourceContextHolder.poll();
}

5.3 性能优化建议

1. 连接池配置优化：

   • 根据并发量调整maxPoolSize
   • 合理设置connectionTimeout和idleTimeout
   • 开启prepareStatement缓存

2. SQL优化：

   • 避免跨数据源关联查询
   • 大数据量查询使用分页
   • 建立合适的索引

6. 常见问题排查

6.1 数据源切换失败

可能原因：

1. 未添加@DS注解或注解值不正确
2. 严格模式关闭且未匹配到数据源
3. 方法调用发生在同类内部（Spring AOP代理问题）

解决方案：

1. 检查注解名称与配置是否一致
2. 开启strict模式快速发现问题
3. 通过ApplicationContext获取代理对象调用

6.2 SQL Server连接问题

常见错误：

1. "驱动程序无法通过使用安全套接字层(SSL)加密与SQL Server建立安全连接"
2. "登录失败"（sa账户禁用或密码错误）

解决方案：

1. 在连接字符串中添加encrypt=false
2. 检查SQL Server身份验证模式是否为混合模式
3. 确认TCP/IP协议已启用

6.3 MyBatisPlus兼容性问题

版本冲突表现：

1. 分页插件失效
2. 自动填充功能异常
3. 乐观锁不生效

解决方案：

1. 保持dynamic-datasource和mybatis-plus版本兼容
2. 检查是否有多个MyBatis配置源
3. 查看启动日志中的版本信息

7. 生产环境部署建议

1. 数据库连接安全：

   • 使用专用账户并限制权限
   • 连接字符串加密存储
   • 启用SSL加密传输

2. 监控与告警：

   • 监控连接池使用情况
   • 设置慢SQL告警
   • 定期检查数据库连接泄漏

3. 高可用方案：

   • 配置数据库集群
   • 实现故障自动转移
   • 设计降级策略

在实际项目中，我们还将多数据源配置与Nacos配置中心集成，实现了动态刷新数据源配置而不需要重启应用。这需要在dynamic-datasource的基础上进行二次开发，主要思路是监听配置变更事件并重新初始化数据源。