如何用Java连接两个MySQL数据库？，怎么上传驱动

在Java应用中同时连接两个MySQL数据库，核心在于合理配置多数据源并确保MySQL JDBC驱动正确上载至项目依赖中。

为什么需要连接两个MySQL数据库

多数业务场景下,单一数据库就能满足需求，但涉及数据隔离、读写分离或者跨系统数据交互时，双数据库连接就成了刚需。

典型业务场景举例

• 一个项目同时访问业务数据库和日志数据库,方便日志独立存储与查询。
• 对接外部系统,需要从另一个MySQL实例拉取数据做同步。
• 微服务架构中,部分服务需要同时操作两个不同的业务库，实现数据汇总或分片。
• 在数据迁移阶段,新旧两个数据库需要并行运行，Java应用得同时连接两者保证平滑过渡。

这些场景里,Java连接两个MySQL数据库的配置方式直接影响系统稳定性和维护成本，行业共识认为，选择合适的多数据源方案，可以避免后续修改代码时反复折腾。

实现双数据库连接的前置准备：上传MySQL驱动

无论是连接一个还是两个MySQL,第一步都是让项目能识别MySQL JDBC驱动。上传MySQL数据库连接驱动到项目依赖中，是跑通数据库操作的基石。

通过Maven自动引入驱动

如果你用的是Maven管理项目,在pom.xml里添加依赖就能自动拉取，不用手动上传。

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> <!-- 版本根据实际MySQL版本选择 -->
</dependency>

Maven会自动从中央仓库下载jar包,如果公司内网环境无法访问外网，就得先手动下载jar包，再安装到本地仓库，或者通过<scope>system</scope>指定本地路径，但这属于如何上传mysql驱动到java项目的另一种变体，本质上还是把驱动文件放到正确位置。

手动上传jar包到项目

有些老项目或者不用Maven的工程,得手动把jar复制到WEB-INF/lib目录下，步骤很简单：

• 从MySQL官网下载对应版本的mysql-connector-java-x.x.x.jar。
• 把jar文件复制到项目的lib文件夹（如果项目没有，就自己建一个）。
• 在IDE中将其添加到Build Path（Eclipse右键jar -> Build Path -> Add to Build Path；IDEA则File -> Project Structure -> Libraries -> + 添加jar）。

注意驱动版本：MySQL 5.x和8.x用的驱动类名不同，5.x是com.mysql.jdbc.Driver，8.x改成了

com.mysql.cj.jdbc.Driver，如果上传的驱动版本和数据库不对应，连接时会直接报错，提示找不到驱动类。

使用Gradle或其他构建工具

Gradle用户则是在build.gradle里添加：

implementation 'mysql:mysql-connector-java:8.0.33'

逻辑和Maven一样,都是通过声明依赖来自动下载。上传MySQL数据库连接驱动这个说法，在构建工具的场景下，更像是指把驱动依赖的信息“上传”到配置文件中，让工具帮你完成后续工作。

两种主流方案：Java连接两个MySQL数据库

现在驱动已经就位,接下来就是怎么在代码里同时连接两个数据库，业内主要有两种思路：基于Spring Boot多数据源配置和原生JDBC直接管理连接。

基于Spring Boot的多数据源配置

Spring Boot通过@Primary和@Qualifier来区分数据源，官方推荐用@Primary标记主数据源，其余用@Qualifier引用，具体步骤：

1. 在application.yml里配置两个数据源连接信息，比如datasource.primary和datasource.secondary。
2. 创建两个数据源配置类,分别读取不同的前缀，并生成对应的DataSource、SqlSessionFactory（如果用MyBatis）和TransactionManager。
3. 使用@Primary标注主数据源相关的Bean，避免自动注入冲突。

示例代码片段（仅示范核心逻辑）：

@Configuration
public class PrimaryDataSourceConfig {
    @Primary
    @Bean(name = "primaryDataSource")
    @ConfigurationProperties(prefix = "datasource.primary")
    public DataSource dataSource() {
        return DataSourceBuilder.create().build();
    }
    @Primary
    @Bean(name = "primarySqlSessionFactory")
    public SqlSessionFactory sqlSessionFactory(@Qualifier("primaryDataSource") DataSource ds) throws Exception {
        SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
        bean.setDataSource(ds);
        return bean.getObject();
    }
}

第二个数据源配置类去掉@Primary，其他逻辑类似，这样在Service层就能通过@Qualifier("primarySqlSessionTemplate")或@Resource(name = "xxx")指定使用哪个数据源。

这种方案很适合Java连接两个MySQL数据库的场景，因为配置清晰，后期扩展第三个数据源也容易，但需要小心事务管理，默认事务只绑定了主数据源，跨库事务要手工处理。

原生JDBC直接管理连接

如果项目没有使用Spring框架,或者只想用最简单的JDBC，那就得手动创建两个Connection对象，分别连接到不同的数据库。

String url1 = "jdbc:mysql://host1:3306/db1";
String url2 = "jdbc:mysql://host2:3306/db2";
String user = "root";
String password = "pass";
Connection conn1 = DriverManager.getConnection(url1, user, password);
Connection conn2 = DriverManager.getConnection(url2, user, password);

然后分别用这两个连接执行SQL,这种方式直接、没有额外框架依赖，但缺点也很明显：

• 连接管理繁琐,需要自己关闭连接。
• 没有连接池,性能差，高并发下容易打满数据库连接。
• 代码重复度高,每个地方都得显式获取和释放连接。

适用场景：一次性数据处理脚本或极轻量级的应用，生产环境很少这么用。

方案对比：Spring Boot多数据源 vs 原生JDBC

从实际项目经验看,Java连接两个MySQL数据库时，Spring Boot多数据源方案占据了相当大的比例，据统计，2026年Java技术栈中，超过七成的多数据源项目都采用Spring Boot配置，这背后是框架对连接池、事务和配置的统一管理，降低了开发者的心智负担。

常见问题与避坑指南

连接两个数据库时,常常会遇到几个坑，提前了解能省不少时间。

驱动版本冲突

如果两个数据库分别是MySQL 5.7和MySQL 8.0，那驱动版本怎么选？MySQL官方文档指出，8.x驱动向后兼容5.x，所以推荐统一使用8.x驱动，但要注意，驱动类名必须用新的com.mysql.cj.jdbc.Driver，并且连接参数useSSL和serverTimezone可能需要显式设置。

数据源配置后的切换失效

在多数据源配置中,如果@Primary

标注不当，或者@Qualifier引用写错，会导致始终使用同一个数据源，检查方法：在配置类中打印DataSource的URL，确认两个Bean确实不同。

连接池耗尽

一个数据源对应一个连接池,默认HikariCP最大连接数10，如果两个数据源都高并发访问，连接池可能被占满，需要根据实际访问量调整maximum-pool-size，比如核心业务库设为20，辅助库设为5。

如何上传mysql驱动到java项目后仍报错

有时手动上传jar后,运行时报ClassNotFoundException，原因通常是jar没有正确包含在运行时类路径中，检查项目部署后的WEB-INF/lib下是否有jar，或者Maven项目是否真的把依赖拉到了target目录，另一种可能是驱动版本和Java版本不兼容，比如用Java 17必须用MySQL Connector/J 8.0.31以上版本。

Java连接两个MySQL数据库并不复杂，只要把驱动上载到位，再根据项目框架选择多数据源配置或原生JDBC即可，重点在于理解事务边界和连接池管理，避免因简单配置埋下性能隐患。

Java连接两个MySQL数据库常见问题解答

Q1: 连接两个数据库需要两个驱动jar吗？

不需要,同一个MySQL JDBC驱动jar可以同时连接不同版本的MySQL实例，只要驱动版本向下兼容就行，比如8.x驱动可以连接5.x和8.x数据库，如果两个数据库版本差异太大，比如一个4.x，另一个8.x，那可能需要分别加载不同版本的驱动，但这种情况极少见，因为MySQL 4.x已停止维护。

Q2: 多数据源配置后，如何动态切换数据库？

在Spring Boot中，可以通过@Qualifier指定数据源，或者用AbstractRoutingDataSource实现动态路由，后者的做法是：在调用前设置一个ThreadLocal变量，然后AbstractRoutingDataSource根据这个变量决定走哪个数据源，这种方式适合在同一个方法内根据业务参数切换数据库，但要注意事务内路由可能失效，最好在事务外切换。

Q3: 手动上传mysql驱动jar包到项目后，还需要额外配置吗？

需要,如果项目是Maven结构，手动上传jar到lib目录后，还需要在pom.xml中添加<dependency>声明，并将scope设为system，同时指定<systemPath>指向jar路径，如果是普通Web项目，只需确保jar在WEB-INF/lib下，Tomcat等容器会自动加载，部署后，建议通过启动日志或测试代码验证驱动是否成功加载，比如调用Class.forName("com.mysql.cj.jdbc.Driver")不抛异常即表示上传成功。