0

0

Java实现多数据源动态切换的详细配置教程

爱谁谁

爱谁谁

发布时间:2025-07-08 16:31:02

|

926人浏览过

|

来源于php中文网

原创

配置多个数据源:在spring配置文件中定义多个数据库连接信息。2. 创建数据源配置类:使用@configurationproperties初始化各个数据源bean。3. 实现abstractroutingdatasource:继承该类并重写determinecurrentlookupkey()方法,结合threadlocal实现动态选择。4. 配置dynamicdatasource:将多个数据源注入到dynamicdatasource中,并设置默认数据源。5. 使用aop切换数据源:通过自定义注解和切面实现自动切换。6. 手动切换数据源:调用setdatasource()和cleardatasource()进行手动控制。7. 配置mybatis:确保sqlsessionfactory使用dynamicdatasource。8. 确保事务一致性:通过platformtransactionmanager与@transactional注解管理事务。9. 处理连接失败:添加健康检查、重试机制及日志记录。10. 应用于微服务架构:支持灵活访问不同数据库,适用于读写分离等场景。

Java实现多数据源动态切换的详细配置教程

Java实现多数据源动态切换,核心在于配置和管理多个数据源,并在运行时根据需要选择合适的数据源进行操作。这通常涉及Spring框架、AbstractRoutingDataSource以及ThreadLocal等技术。

Java实现多数据源动态切换的详细配置教程

解决方案:

Java实现多数据源动态切换的详细配置教程
  1. 配置多个数据源: 首先,在Spring配置文件(例如application.propertiesapplication.yml)中定义多个数据源。每个数据源对应一个数据库连接配置,包括URL、用户名、密码、驱动类等。

    立即学习Java免费学习笔记(深入)”;

    spring.datasource.primary.url=jdbc:mysql://localhost:3306/db_primary?useSSL=false&serverTimezone=UTC
    spring.datasource.primary.username=root
    spring.datasource.primary.password=password
    spring.datasource.primary.driver-class-name=com.mysql.cj.jdbc.Driver
    
    spring.datasource.secondary.url=jdbc:mysql://localhost:3306/db_secondary?useSSL=false&serverTimezone=UTC
    spring.datasource.secondary.username=root
    spring.datasource.secondary.password=password
    spring.datasource.secondary.driver-class-name=com.mysql.cj.jdbc.Driver
  2. 创建数据源配置类: 创建一个Java配置类,用于初始化这些数据源Bean。

    Java实现多数据源动态切换的详细配置教程
    import org.springframework.boot.context.properties.ConfigurationProperties;
    import org.springframework.boot.jdbc.DataSourceBuilder;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.context.annotation.Primary;
    
    import javax.sql.DataSource;
    
    @Configuration
    public class DataSourceConfig {
    
        @Primary
        @Bean(name = "primaryDataSource")
        @ConfigurationProperties(prefix = "spring.datasource.primary")
        public DataSource primaryDataSource() {
            return DataSourceBuilder.create().build();
        }
    
        @Bean(name = "secondaryDataSource")
        @ConfigurationProperties(prefix = "spring.datasource.secondary")
        public DataSource secondaryDataSource() {
            return DataSourceBuilder.create().build();
        }
    }
  3. 实现AbstractRoutingDataSource: 创建一个类继承AbstractRoutingDataSource,并重写determineCurrentLookupKey()方法。这个方法负责决定使用哪个数据源。

    import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
    
    public class DynamicDataSource extends AbstractRoutingDataSource {
    
        private static final ThreadLocal<String> contextHolder = new ThreadLocal<>();
    
        public static void setDataSource(String dataSource) {
            contextHolder.set(dataSource);
        }
    
        public static String getDataSource() {
            return contextHolder.get();
        }
    
        public static void clearDataSource() {
            contextHolder.remove();
        }
    
        @Override
        protected Object determineCurrentLookupKey() {
            return getDataSource();
        }
    }
  4. 配置DynamicDataSource: 在配置类中配置DynamicDataSource,并将之前定义的数据源注入。

    import org.springframework.beans.factory.annotation.Qualifier;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.jdbc.datasource.DataSourceTransactionManager;
    import org.springframework.transaction.PlatformTransactionManager;
    
    import javax.sql.DataSource;
    import java.util.HashMap;
    import java.util.Map;
    
    @Configuration
    public class DynamicDataSourceConfig {
    
        @Bean
        public DynamicDataSource dynamicDataSource(@Qualifier("primaryDataSource") DataSource primaryDataSource,
                                                  @Qualifier("secondaryDataSource") DataSource secondaryDataSource) {
            Map<Object, Object> targetDataSources = new HashMap<>();
            targetDataSources.put("primary", primaryDataSource);
            targetDataSources.put("secondary", secondaryDataSource);
    
            DynamicDataSource dynamicDataSource = new DynamicDataSource();
            dynamicDataSource.setTargetDataSources(targetDataSources);
            dynamicDataSource.setDefaultTargetDataSource(primaryDataSource); // 默认数据源
            return dynamicDataSource;
        }
    
        @Bean
        public PlatformTransactionManager transactionManager(DynamicDataSource dynamicDataSource) {
            return new DataSourceTransactionManager(dynamicDataSource);
        }
    }
  5. 使用AOP切换数据源: (可选) 可以使用AOP来自动切换数据源,例如基于方法注解。

    人民网AIGC-X
    人民网AIGC-X

    国内科研机构联合推出的AI生成内容检测工具

    下载
    import org.aspectj.lang.JoinPoint;
    import org.aspectj.lang.annotation.After;
    import org.aspectj.lang.annotation.Aspect;
    import org.aspectj.lang.annotation.Before;
    import org.springframework.stereotype.Component;
    
    @Aspect
    @Component
    public class DataSourceAspect {
    
        @Before("@annotation(UsePrimaryDataSource)") // 自定义注解
        public void setPrimaryDataSource(JoinPoint joinPoint) {
            DynamicDataSource.setDataSource("primary");
        }
    
        @Before("@annotation(UseSecondaryDataSource)") // 自定义注解
        public void setSecondaryDataSource(JoinPoint joinPoint) {
            DynamicDataSource.setDataSource("secondary");
        }
    
        @After("@annotation(UsePrimaryDataSource) || @annotation(UseSecondaryDataSource)")
        public void restoreDataSource(JoinPoint joinPoint) {
            DynamicDataSource.clearDataSource();
        }
    }

    需要定义UsePrimaryDataSourceUseSecondaryDataSource注解。

  6. 手动切换数据源: 在需要切换数据源的地方,调用DynamicDataSource.setDataSource("dataSourceName")方法。 完成后,调用DynamicDataSource.clearDataSource()清除ThreadLocal中的数据源信息。

  7. 配置Mybatis: 配置Mybatis使用DynamicDataSource

    import org.apache.ibatis.session.SqlSessionFactory;
    import org.mybatis.spring.SqlSessionFactoryBean;
    import org.mybatis.spring.SqlSessionTemplate;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
    import org.springframework.core.io.support.ResourcePatternResolver;
    
    import javax.sql.DataSource;
    
    @Configuration
    public class MybatisConfig {
    
        @Autowired
        private DynamicDataSource dynamicDataSource;
    
        @Bean
        public SqlSessionFactory sqlSessionFactory() throws Exception {
            SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
            factoryBean.setDataSource(dynamicDataSource);
            ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
            factoryBean.setMapperLocations(resolver.getResources("classpath:mapper/*.xml")); // mapper文件路径
            return factoryBean.getObject();
        }
    
        @Bean
        public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) throws Exception {
            return new SqlSessionTemplate(sqlSessionFactory);
        }
    }

如何确保数据源切换的事务一致性?

使用@Transactional注解结合PlatformTransactionManager可以管理事务。确保PlatformTransactionManager使用的是DynamicDataSource。 在切换数据源前开启事务,切换数据源后,事务会自动应用到当前数据源。

如何优雅地处理数据源连接失败的情况?

DynamicDataSource中,可以添加数据源健康检查机制。 定期检查数据源的连接状态,如果连接失败,可以尝试重新连接或者切换到备用数据源。 可以使用Spring Retry模块实现自动重试。 此外,可以记录数据源连接失败的日志,方便排查问题。

多数据源动态切换在微服务架构中的应用场景?

在微服务架构中,每个服务可能需要访问不同的数据库。 多数据源动态切换可以帮助服务灵活地访问不同的数据源,而无需修改代码。 例如,一个服务可能需要访问订单数据库、用户数据库和商品数据库。 通过多数据源动态切换,可以根据业务需求选择合适的数据源。 此外,多数据源动态切换还可以用于读写分离,将读操作路由到只读数据库,将写操作路由到主数据库。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

156

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

88

2026.01.26

mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

303

2023.08.21

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

94

2024.02.23

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

106

2024.02.23

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2024.02.23

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2024.02.23

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

136

2025.08.26

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.5万人学习

Git 教程
Git 教程

共21课时 | 4.2万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号