Spring Boot项目中结合MyBatis实现MySQL的自动主从切换功能

 更新时间:2025年04月10日 11:08:30   作者:山高自有客行路  
这篇文章主要介绍了Spring Boot项目中结合MyBatis实现MySQL的自动主从切换功能,本文分步骤给大家介绍的非常详细,感兴趣的朋友一起看看吧

原理解析

1. MySQL主从复制(Master-Slave Replication)

  • 工作原理:MySQL主从复制通过二进制日志(binary log)来同步数据。主服务器记录所有更改操作到二进制日志中,从服务器读取这些日志并执行相应的SQL语句来保持与主服务器的数据一致。
  • 延迟问题:由于网络传输和处理时间,从库可能会有短暂的数据滞后,这对于需要实时一致性的场景是一个挑战。

2. 读写分离

  • 目的:提高系统性能和可用性。通过将读请求分配给从库,写请求发送给主库,可以减少主库的压力,提升系统的整体性能。
  • 实现方式:可以通过数据库中间件或框架层面的配置来实现。在这个例子中,我们使用Apache ShardingSphere来实现读写分离。

3. 自动故障转移

  • 原理:当检测到主库不可用时,系统会自动选择一个从库作为新的主库,并重新调整读写分配。这通常涉及到心跳检测、状态监控等机制。
  • 工具支持:除了ShardingSphere外,还可以使用MHA(MySQL Master High Availability)或其他高可用解决方案。

实现步骤详解

1. 引入依赖

pom.xml中添加必要的依赖,包括Spring Boot Starter、MyBatis Starter以及ShardingSphere:

深色版本

<dependencies>
    <!-- Spring Boot Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <!-- MyBatis Starter -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>
    <!-- ShardingSphere for read-write splitting -->
    <dependency>
        <groupId>org.apache.shardingsphere</groupId>
        <artifactId>sharding-jdbc-spring-boot-starter</artifactId>
        <version>4.1.1</version>
    </dependency>
</dependencies>

2. 配置数据源

编辑application.yml文件以配置多个数据源,并设置ShardingSphere规则以实现读写分离:

深色版本

spring:
  shardingsphere:
    datasource:
      names: master,slave0,slave1
      master:
        type: com.zaxxer.hikari.HikariDataSource
        driver-class-name: com.mysql.cj.jdbc.Driver
        jdbc-url: jdbc:mysql://master_host:3306/your_db?useSSL=false&serverTimezone=UTC
        username: your_username
        password: your_password
      slave0:
        type: com.zaxxer.hikari.HikariDataSource
        driver-class-name: com.mysql.cj.jdbc.Driver
        jdbc-url: jdbc:mysql://slave0_host:3306/your_db?useSSL=false&serverTimezone=UTC
        username: your_username
        password: your_password
      slave1:
        type: com.zaxxer.hikari.HikariDataSource
        driver-class-name: com.mysql.cj.jdbc.Driver
        jdbc-url: jdbc:mysql://slave1_host:3306/your_db?useSSL=false&serverTimezone=UTC
        username: your_username
        password: your_password
    masterslave:
      load-balance-algorithm-type: round_robin # 负载均衡策略
      name: ms_ds # 数据源名称
      master-data-source-name: master # 主库数据源名称
      slave-data-source-names: slave0,slave1 # 从库数据源名称列表
    props:
      sql:
        show: true # 是否显示SQL语句

3. 配置MyBatis

创建MyBatis Mapper接口,并使用注解或XML配置SQL语句。这里以注解方式为例:

深色版本

package com.example.demo.mapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import java.util.List;
import java.util.Map;
@Mapper
public interface UserMapper {
    /**
     * 查询所有用户信息.
     * 注意:对于查询操作,ShardingSphere会选择其中一个从库来执行查询。
     *
     * @return 用户信息列表
     */
    @Select("SELECT * FROM users")
    List<Map<String, Object>> findAllUsers();
    /**
     * 更新用户信息.
     * 注意:写操作只会针对主库执行。
     *
     * @param id 用户ID
     * @param newName 新用户名
     */
    void updateUserById(@Param("id") Long id, @Param("newName") String newName);
}

确保你的Spring Boot应用扫描到Mapper接口。可以在主类上添加@MapperScan注解:

深色版本

package com.example.demo;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@MapperScan("com.example.demo.mapper")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

4. 使用Mapper进行数据库操作

现在你可以在Service层中注入并使用Mapper接口来进行数据库操作:

深色版本

package com.example.demo.service;
import com.example.demo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
import java.util.Map;
@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;
    /**
     * 获取所有用户信息.
     *
     * @return 用户信息列表
     */
    public List<Map<String, Object>> getAllUsers() {
        return userMapper.findAllUsers();
    }
    /**
     * 更新用户名称.
     *
     * @param id       用户ID
     * @param newName 新用户名
     */
    public void updateUserName(Long id, String newName) {
        userMapper.updateUserById(id, newName);
    }
}

注意事项及最佳实践

  • 事务管理:确保所有写操作都在同一个事务中执行,并且只对主库进行写操作。可以使用@Transactional注解来管理事务。
  • 数据一致性:考虑到主从复制延迟的问题,在某些场景下(如刚完成写操作后立即读取),可能需要直接查询主库以保证数据一致性。
  • 健康检查:建议定期监控主从状态,确保从库同步正常以及主库可访问。可以通过定时任务或者外部工具来实现。
  • 性能优化:根据实际业务需求调整负载均衡策略,例如采用权重轮询或其他高级算法来优化查询效率。

到此这篇关于Spring Boot项目中结合MyBatis实现MySQL的自动主从切换的文章就介绍到这了,更多相关Spring Boot MyBatis自动主从切换内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java Spring Cloud Bus 实现配置实时更新详解

    Java Spring Cloud Bus 实现配置实时更新详解

    这篇文章主要介绍了SpringCloud Bus如何实现配置刷新,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2021-09-09
  • Java根据实体生成SQL数据库表的示例代码

    Java根据实体生成SQL数据库表的示例代码

    这篇文章主要来和大家分享一个Java实现根据实体生成SQL数据库表的代码,文中的实现代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-07-07
  • Java实现生成JSON字符串的三种方式分享

    Java实现生成JSON字符串的三种方式分享

    这篇文章主要来和大家分享一下Java实现生成JSON字符串的常见三种方式,文中的示例代码讲解详细,具有一定的学习价值,需要的可以参考一下
    2023-05-05
  • 一文带你完全掌握SpringBoot中配置的优先级

    一文带你完全掌握SpringBoot中配置的优先级

    在现代Spring Boot应用开发中,理解配置文件的加载顺序和优先级至关重要,本文将深入剖析包括Nacos远程配置、本地properties和yml文件在内的各种配置源的优先级关系,希望可以帮助开发者掌握配置管理的最佳实践
    2026-03-03
  • Spring 异步接口返回结果的四种方式

    Spring 异步接口返回结果的四种方式

    这篇文章主要介绍了Spring 异步接口返回结果的四种方式,文章围绕主题展开详细的内容介绍,具有一定的参考价值,感兴趣的小伙伴可以参考一下
    2022-08-08
  • Java枚举类的规范设计与常见错误规避指南

    Java枚举类的规范设计与常见错误规避指南

    在Java开发中,枚举(enum)是一种强大的工具,用于定义一组固定常量集合,然而,许多开发者在使用枚举时容易陷入设计误区,导致代码可维护性差、运行时错误频发,甚至引发生产事故,所以本文给大家介绍了Java枚举类的规范设计与常见错误规避,需要的朋友可以参考下
    2025-06-06
  • SpringBoot项目打包为JAR文件的实现

    SpringBoot项目打包为JAR文件的实现

    本文主要介绍了SpringBoot项目打包为JAR文件的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-09-09
  • 关于Spring Boot动态权限变更问题的实现方案

    关于Spring Boot动态权限变更问题的实现方案

    这篇文章主要介绍了Spring Boot动态权限变更实现的整体方案使用session作为缓存,结合AOP技术进行token认证和权限控制,本文给大家介绍的非常详细,需要的朋友参考下吧
    2021-06-06
  • Java基础第五篇 实施接口

    Java基础第五篇 实施接口

    在public和private的封装机制,我们实际上同时定义了类和接口,类和接口混合在一起。Java还提供了interface这一语法。这一语法将接口从类的具体定义中剥离出来,构成一个独立的主体,下面文章内容将为大家做详细介绍
    2021-09-09
  • SpringBoot HTTP服务开发从入门到部署完整流程

    SpringBoot HTTP服务开发从入门到部署完整流程

    本文将基于SpringBoot+Gradle技术栈,从零开始构建一个简单的HTTP服务,逐步实现从项目初始化、API开发、业务逻辑构建到最终部署上线的全流程,感兴趣的朋友跟随小编一起看看吧
    2026-02-02

最新评论