Java双数据库管理实战指南，如何配置多数据源与切换？

结论是：在Java应用中，通过使用Spring Boot配合AbstractRoutingDataSource，配置多个数据源并在运行时动态切换，可以实现高效的双数据库管理。

为什么要使用双数据源？

很多项目在发展中会出现数据库拆分的情况，比如主数据库用于日常业务，另一个数据库用于存放历史数据或专门处理某些报告。如果每次都要手动切换连接会很麻烦，双数据源配置能让代码在需要时自动切换到正确的数据库，这样开发起来更直观，系统运行也更稳定。

第一步：添加必要的依赖

开始之前，确保你的Spring Boot项目已经引入了相关的数据库驱动。如果你用的是MySQL，需要在pom.xml文件里加入MySQL连接驱动和Spring Data JPA的依赖。Spring Boot会自动管理版本，你只需简单声明即可。

第二步：定义数据源配置

在application.properties或application.yml中，为两个数据库分别定义连接信息。例如，给主数据库起名叫primary，给副数据库起名叫secondary，分别设置它们的URL、用户名、密码等基本参数。这里的关键是给每个数据源一个明确的名字，方便后续引用。

第三步：创建数据源Bean

在Java配置类中，你需要创建两个数据源对象，对应上一步配置的两个数据库。使用@Bean注解，并指定它们的名称，比如primaryDataSource和secondaryDataSource。Spring Boot会读取配置文件，自动完成连接。

第四步：实现动态数据源路由

这是核心步骤。你需要创建一个类继承AbstractRoutingDataSource，并重写determineCurrentLookupKey方法。这个方法会返回一个key，比如“primary”或“secondary”，系统根据这个key选择对应的数据源。同时，你还需要一个ThreadLocal变量来存储当前线程应该使用的key，确保每个请求都能正确切换。

第五步：配置数据源管理器

将上一步创建的路由数据源配置为Spring的Bean。设置它的targetDataSources属性，把primaryDataSource和secondaryDataSource映射到对应的key上，并指定默认数据源。这样，当请求到来时，数据源管理器就能根据key选择正确的数据库连接。

第六步：使用注解切换数据源

为了方便，可以定义一个自定义注解，比如@DataSource，用来标记方法或类应该使用哪个数据源。然后通过AOP切面，在方法执行前设置ThreadLocal中的key，执行后清理。这样，在代码中只需添加注解，就能实现数据源切换，无需手动干预。

注意事项

配置多数据源时，要特别注意事务管理。默认的事务管理器可能无法正确处理跨数据源的事务，建议为每个数据源配置独立的事务管理器，并在需要时指定使用哪个。此外，确保数据库连接池配置合理，避免资源浪费或连接泄漏。

FAQ

Q: 双数据源配置会导致性能下降吗？
A: 如果配置得当，性能影响很小。主要开销在于连接池管理和路由逻辑，但现代应用服务器通常能高效处理这些操作。建议根据实际负载调整连接池参数。

Q: 我可以配置两个以上的数据源吗？
A: 当然可以，上述方法可以扩展到任意多个数据源。只需在配置文件中添加更多连接信息，并在路由类中处理相应的key即可。

Q: 如果切换失败怎么办？
A: 首先检查ThreadLocal中的key是否被正确设置和清理，避免内存泄漏。其次，确保数据库连接参数无误，网络通畅。日志是排查问题的好帮手，建议在关键步骤添加日志记录。

引用来源：本文内容基于Spring Boot官方文档和多数据源配置的常见实践，具体实现可参考Spring Framework的AbstractRoutingDataSource类以及相关社区教程。