解决MySQL驱动警告: com.mysql.jdbc.Driver已弃用

MySQL JDBC 驱动类加载警告：com.mysql.jdbc.Driver 已弃用

在连接 MySQL 数据库时，你可能会在控制台看到类似以下的警告信息：

Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.

这条警告信息的意思很明确：com.mysql.jdbc.Driver 这个驱动类已经被弃用了，应该使用新的驱动类 com.mysql.cj.jdbc.Driver。

问题原因

MySQL Connector/J 的版本更新导致了驱动类的变更。旧版本的 Connector/J 使用 com.mysql.jdbc.Driver 作为驱动类。从 Connector/J 8.0 开始，推荐使用 com.mysql.cj.jdbc.Driver。

虽然旧的驱动类仍然可以使用，但为了保持兼容性和利用新版本的特性，建议更新到新的驱动类。

解决方案

有几种方法可以解决这个问题，它们的核心都是更新驱动类名称或者移除显式的驱动加载：

1. 更新驱动类名 (推荐)

这是最直接、最推荐的解决方法。只需将代码中所有用到 com.mysql.jdbc.Driver 的地方替换成 com.mysql.cj.jdbc.Driver 即可。

修改前 (例如, 使用 Class.forName() 加载驱动)：

try {
    Class.forName("com.mysql.jdbc.Driver");
    // ... 其他代码 ...
} catch (ClassNotFoundException e) {
    e.printStackTrace();
}

修改后：

try {
    Class.forName("com.mysql.cj.jdbc.Driver");
    // ... 其他代码 ...
} catch (ClassNotFoundException e) {
    e.printStackTrace();
}

修改前 (例如，在 JDBC URL 中指定驱动):

String url = "jdbc:mysql://localhost:3306/mydatabase?driver=com.mysql.jdbc.Driver";
// 或者更常见的，不直接在url写
Connection conn = DriverManager.getConnection(url, username, password);

修改后 (在URL中): 尽管通常不需要，但URL中也可以直接不写驱动名。 或者明确指定新的驱动:

String url = "jdbc:mysql://localhost:3306/mydatabase";
// 或者, 但不是必须
String url_new = "jdbc:mysql://localhost:3306/mydatabase?driver=com.mysql.cj.jdbc.Driver";

Connection conn = DriverManager.getConnection(url, username, password);

更常见的，连接字符串里根本不用指定driver。直接jdbc:mysql://localhost:3306/mydatabase就好。

2. 移除显式驱动加载 (更推荐，适用于 Connector/J 8.0+)

Connector/J 8.0 及更高版本支持通过 Service Provider Interface (SPI) 自动注册驱动。这意味着，通常情况下，你根本不需要手动加载驱动类。

所以，你可以直接删除类似 Class.forName("com.mysql.jdbc.Driver") 或 Class.forName("com.mysql.cj.jdbc.Driver") 的代码行。

修改前：

try {
    Class.forName("com.mysql.jdbc.Driver"); // 或 Class.forName("com.mysql.cj.jdbc.Driver");
    Connection conn = DriverManager.getConnection(url, username, password);
    // ... 其他代码 ...
} catch (ClassNotFoundException e) {
    e.printStackTrace();
} catch (SQLException e){
   e.printStackTrace();
}

修改后 (直接移除 Class.forName()):

try {
    Connection conn = DriverManager.getConnection(url, username, password);
    // ... 其他代码 ...
}  catch (SQLException e){
   e.printStackTrace();
}

这种方式更加简洁，也避免了潜在的驱动类加载问题。只要你的 classpath 中包含了 Connector/J 的 JAR 包，驱动程序就会自动加载。

3. 使用连接池（最佳实践）

在实际开发中，通常不直接使用 DriverManager 来获取数据库连接。 更好的方式是使用连接池，比如 HikariCP、c3p0、Druid 等。连接池可以管理数据库连接的创建、复用和销毁，提高应用程序的性能和资源利用率。

这些连接池通常会在配置中指定驱动类名。同样，你需要将 com.mysql.jdbc.Driver 替换为 com.mysql.cj.jdbc.Driver。

以 HikariCP 为例 (配置文件通常是 hikari.properties 或 application.properties/yml)：

修改前 (hikari.properties):

driverClassName=com.mysql.jdbc.Driver
jdbcUrl=jdbc:mysql://localhost:3306/mydatabase
username=your_username
password=your_password
# ... 其他配置 ...

修改后：

driverClassName=com.mysql.cj.jdbc.Driver
jdbcUrl=jdbc:mysql://localhost:3306/mydatabase
username=your_username
password=your_password
# ... 其他配置 ...

Java 代码示例 (配合HikariCP)：

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;

import java.sql.Connection;
import java.sql.SQLException;

public class DatabaseConnection {

    private static HikariDataSource dataSource;

    static {
        HikariConfig config = new HikariConfig();
        config.setDriverClassName("com.mysql.cj.jdbc.Driver"); // 确保这里也是新的驱动
        config.setJdbcUrl("jdbc:mysql://localhost:3306/mydatabase");
        config.setUsername("your_username");
        config.setPassword("your_password");
        // ... 其他 HikariCP 配置 ...
        dataSource = new HikariDataSource(config);
    }

    public static Connection getConnection() throws SQLException {
        return dataSource.getConnection();
    }

    // ... 其他数据库操作方法 ...
}

但对于HikariCP，它内部也实现了自动检测，不指定driverClassName一般也没事，但建议还是加上。

其他情况及注意事项

• Maven/Gradle 项目： 如果你的项目使用了 Maven 或 Gradle 等构建工具，检查你的 pom.xml (Maven) 或 build.gradle (Gradle) 文件中，MySQL Connector/J 的依赖是否是较新的版本 (8.0 或更高)。
• 旧项目： 如果你的项目比较老，可能需要更新相关的依赖库，包括 JDBC 驱动和连接池。
• 服务器环境: 检查你的应用程序服务器（如 Tomcat）的配置。有些服务器可能会有自己的 JDBC 驱动配置。
• ** 时区问题：** Connector/J 8.0 在处理时区方面也有一些变化。如果在升级后遇到时区相关的问题，可以考虑在 JDBC URL 中添加 serverTimezone 参数，例如：jdbc:mysql://localhost:3306/mydatabase?serverTimezone=UTC。（根据需要调整时区）。 进一步, 还可能要配置useLegacyDatetimeCode=false

进阶: Connector/J 8.0 的一些改进

• 自动注册: Connector/J 8.0 利用 Java 的 Service Provider Interface (SPI) 机制，实现了驱动的自动注册。这减少了手动加载驱动类的需要。
• 性能优化: 新版本通常包含性能优化和 bug 修复。
• 更好的异常处理: Connector/J 8.0 可能有更细粒度的异常处理机制。
• X DevAPI: 支持 MySQL 的 X DevAPI，允许以更现代的方式与 MySQL 数据库交互，例如使用文档存储功能. 要开启, 可能还要在连接字符串里添加一些参数，比如useSSL=false。
• TLS/SSL改进 : 如果使用加密链接, Connector/J 对 TLS 有更好的支持，包括一些较新协议版本，并提供更完善的配置选项. 可能需要配置tlsVersions 等。

总之, 碰到了这个警告, 直接更新驱动类名是最简单的解决方案, 然后去除代码里手动加载驱动的操作。使用连接池更是生产环境中推荐的方式. 更新新版本也有利于使用新特性, 并得到性能和安全性的改进。