在Spring Boot + MyBatis项目中实现MySQL读写分离

举报
悟空码字 发表于 2025/12/20 11:04:49 2025/12/20
【摘要】 在Spring Boot和MyBatis项目中实现MySQL读写分离,主要有两种思路:一种是在应用层通过代码和配置手动控制,另一种是借助中间件自动路由。

Spring BootMyBatis项目中实现MySQL读写分离,主要有两种思路:一种是在应用层通过代码和配置手动控制,另一种是借助中间件自动路由。

下面是几种主流的实现方案,并提供一个基于Spring抽象路由数据源的实战指南。

🎯 如何选择实现方案

你可以根据项目的复杂度、团队的技术栈和运维能力,参考下表进行选择:

对于大多数Java开发者来说,从应用层手动分离开始学习是最直观的路径。

🔧 核心实现:应用层手动分离

这种方法的核心是利用Spring的 AbstractRoutingDataSource 来动态决定使用哪个数据源。

主要步骤

1、配置多个数据源

在你的application.yml文件中,分别配置主库和从库的连接信息。

spring:
  datasource:
    master:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://master-host:3306/db_name
      username: root
      password: master-pass
    slave:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://slave-host:3306/db_name
      username: root
      password: slave-pass

2、创建数据源上下文持有者

使用ThreadLocal来安全地存储和获取当前线程需要使用的数据源键值。

public class DataSourceContextHolder {
    private static final ThreadLocal<String> CONTEXT_HOLDER = new ThreadLocal<>();
    
    public static void setDataSourceType(String dataSourceType) {
        CONTEXT_HOLDER.set(dataSourceType);
    }
    
    public static String getDataSourceType() {
        return CONTEXT_HOLDER.get();
    }
    
    public static void clearDataSourceType() {
        CONTEXT_HOLDER.remove();
    }
}

3、创建动态数据源类

继承AbstractRoutingDataSource并重写determineCurrentLookupKey方法,使其从上下文持有者中获取数据源键值。

public class DynamicDataSource extends AbstractRoutingDataSource {
    @Override
    protected Object determineCurrentLookupKey() {
        return DataSourceContextHolder.getDataSourceType();
    }
}

4、使用AOP自动切换数据源

通过切面,根据方法名或自定义注解自动设置数据源。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Master {
}

5、处理特殊情况:强制读主库

在某些需要实时读取数据的场景(如刚写入后立刻查询),你可以使用自定义注解来强制方法走主库。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Master {
}

然后在切面中增加对@Master注解的判断,优先使用主库。

⚠️ 实施中的关键问题与解决方案

主从延迟问题:这是读写分离架构中最常见的挑战。对于需要实时性保证的查询,可以使用上面提到的@Master注解强制走主库。

事务管理:为了确保数据一致性,在写操作(如@Transactional注解的方法)中,整个事务内的所有数据库操作都应使用主库。你可以在事务开始时就强制指定数据源为主库。

故障转移与监控:需要建立从库健康检查机制。当监测到从库延迟过大或宕机时,应能自动将读请求降级到主库,保证系统的可用性。

💎 总结

实现Spring Boot + MyBatis的读写分离,应用层手动方案适合快速上手和理解原理,而中间件方案则在动态扩展和运维管理上更有优势。

在学习或中小型项目中先从应用层方案入手,随着业务规模扩大,再平滑迁移到ProxySQL或ShardingSphere等更强大的中间件上。

在Spring Boot + MyBatis项目中实现MySQL读写分离.png

谢谢你看我的文章,既然看到这里了,如果觉得不错,随手点个赞、转发、在看三连吧,感谢感谢。那我们,下次再见。

您的一键三连,是我更新的最大动力,谢谢

山水有相逢,来日皆可期,谢谢阅读,我们再会

我手中的金箍棒,上能通天,下能探海

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。