MyBatis多数据源：Spring Boot多数据库操作终极指南

【免费下载链接】spring-boot-demo 🚀一个用来深入学习并实战 Spring Boot 的项目。 项目地址: https://gitcode.com/gh_mirrors/sp/spring-boot-demo

在现代企业级应用开发中，Spring Boot凭借其快速开发特性成为Java开发者的首选框架。而面对复杂业务场景时，单一数据源往往难以满足需求——例如电商系统需要同时操作订单数据库和用户数据库，或者数据分片存储在不同数据库实例中。MyBatis多数据源解决方案正是为解决这类问题而生，它能帮助开发者优雅地管理多个数据库连接，实现数据的灵活操作。

为什么需要多数据源？

多数据源架构在实际开发中有着广泛的应用场景：

• 数据隔离：将核心业务数据与日志、统计等非核心数据分离存储
• 读写分离：主库写入、从库读取，提升系统性能
• 分库分表：大型应用按业务模块或数据量拆分数据库
• 多系统集成：企业内部不同系统间数据交互需求

Spring Boot结合MyBatis实现多数据源有多种方案，其中Mybatis-Plus提供的动态数据源解决方案因其配置简单、功能强大而被广泛采用。

快速上手：MyBatis多数据源实现步骤

1. 准备工作

首先确保已通过Git克隆项目代码：

git clone https://gitcode.com/gh_mirrors/sp/spring-boot-demo
cd spring-boot-demo/demo-multi-datasource-mybatis

该示例项目结构清晰，核心实现代码位于demo-multi-datasource-mybatis目录下，数据库脚本文件为sql/db.sql，包含了基础用户表结构定义。

2. 核心依赖配置

在项目的pom.xml中添加MyBatis-Plus动态数据源依赖：

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
  <version>最新版本</version>
</dependency>

3. 数据源配置

在application.yml中配置多个数据源信息：

spring:
  datasource:
    dynamic:
      primary: master # 设置默认数据源
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/master_db
          username: root
          password: 123456
        slave:
          url: jdbc:mysql://localhost:3306/slave_db
          username: root
          password: 123456

4. 使用注解切换数据源

通过@DS注解轻松切换数据源：

@Service
public class UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    // 使用主数据源
    @DS("master")
    public User saveUser(User user) {
        userMapper.insert(user);
        return user;
    }
    
    // 使用从数据源
    @DS("slave")
    public List<User> listUsers() {
        return userMapper.selectList(null);
    }
}

高级应用：多数据源事务管理

在多数据源场景下，事务管理需要特别注意。MyBatis-Plus动态数据源支持两种事务策略：

1. 单数据源事务：默认支持，使用@Transactional注解即可
2. 多数据源事务：需结合分布式事务解决方案，如Seata

实际应用场景展示

多数据源架构在实际项目中表现出色，以下是一个典型的业务流程：

1. 用户下单时，系统通过主数据源写入订单数据
2. 同时通过从数据源读取商品库存信息
3. 订单完成后，通过日志数据源记录操作日志

这种架构不仅提高了系统性能，还增强了数据安全性和可维护性。

常见问题与解决方案

数据源切换失效

原因：AOP切面顺序问题或方法内部调用未通过代理

解决方案：确保@DS注解标注在public方法上，且通过Spring容器调用

事务不生效

解决方案：检查是否使用了正确的事务管理器，多数据源场景需指定对应数据源的事务管理器

总结

MyBatis多数据源解决方案为Spring Boot应用提供了灵活的数据访问能力，特别适合中大型企业级应用。通过Mybatis-Plus的动态数据源starter，我们可以用最少的配置实现复杂的多数据源管理，极大提升开发效率。

项目中提供了完整的MyBatis多数据源示例代码，包含了从配置到使用的全部细节，建议结合实际业务场景进行扩展和优化。

【免费下载链接】spring-boot-demo 🚀一个用来深入学习并实战 Spring Boot 的项目。 项目地址: https://gitcode.com/gh_mirrors/sp/spring-boot-demo