已安装MySQL Connector/J仍报NoSuitableDriverFound异常求助

核心问题梳理 #

1. Maven依赖缺失：你的pom.xml中未声明MySQL Connector/J的依赖，即使手动下载了驱动，Maven构建时也不会将其纳入运行环境，导致JVM找不到驱动类。
2. MySQL 8.0+ URL参数不全：MySQL 8.0及以上版本要求JDBC URL必须指定时区参数，否则不仅会触发时区异常，也可能间接导致驱动匹配失败。
3. 驱动类加载问题（潜在）：尽管JDBC 4.0+支持驱动自动注册，但部分类加载器隔离场景下，可能需要显式触发驱动类加载。

分步解决方案 #

1. 补充Maven驱动依赖 #

在pom.xml的<project>节点内添加<dependencies>块，引入适配Java 11的MySQL Connector/J版本（推荐8.0.x系列）：

<dependencies>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

• runtime作用域：表示编译阶段无需依赖，仅运行时需要，符合JDBC驱动的使用场景。
• 版本选择：确保版本与你的MySQL服务器版本兼容（MySQL 8.0对应Connector/J 8.0+）。

2. 修正JDBC URL格式 #

为MySQL 8.0+添加时区参数，同时关闭不必要的SSL连接（本地测试场景）：

String uri = "jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC";

• 时区可替换为你所在的时区，例如Asia/Shanghai。

3. 显式加载驱动类（可选，解决类加载问题） #

在获取数据库连接前，添加显式加载驱动类的代码，确保驱动被注册到DriverManager：

Class.forName("com.mysql.cj.jdbc.Driver");

• 若依赖配置正确，该行代码不会抛出ClassNotFoundException；若抛出异常，说明依赖未正确引入。

4. 验证驱动注册状态（调试用） #

可添加以下代码打印已注册的驱动，确认驱动是否被成功加载：

Enumeration<Driver> drivers = DriverManager.getDrivers();
while (drivers.hasMoreElements()) {
    Driver driver = drivers.nextElement();
    System.out.println("已注册驱动：" + driver.getClass().getName());
}

修改后的完整代码示例 #

package com.mycompany.mavenproject1;

import java.sql.Connection;
import java.sql.Driver;
import java.sql.DriverManager;
import java.sql.Statement;
import java.sql.SQLException;
import java.util.Enumeration;

public class Mavenproject1{

    public static void main(String[] args) {
        String uri = "jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC";
        try{
            // 显式加载驱动（可选）
            Class.forName("com.mysql.cj.jdbc.Driver");
            
            // 打印已注册驱动（调试用）
            Enumeration<Driver> drivers = DriverManager.getDrivers();
            while (drivers.hasMoreElements()) {
                Driver driver = drivers.nextElement();
                System.out.println("已注册驱动：" + driver.getClass().getName());
            }
            
            Connection conn = DriverManager.getConnection(uri, "root", "Miskin@1982");
            Statement stmt = conn.createStatement();
            System.out.println("数据库连接成功！");
            
            // 记得关闭资源（示例省略，实际项目需添加）
            stmt.close();
            conn.close();
        }catch(SQLException | ClassNotFoundException e){
            e.printStackTrace();
        }
    }
}  

修改后的pom.xml示例 #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.mycompany</groupId>
    <artifactId>mavenproject1</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <exec.mainClass>com.mycompany.mavenproject1.Mavenproject1</exec.mainClass>
    </properties>
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version>
            <scope>runtime</scope>
        </dependency>
    </dependencies>
</project>

内容的提问来源于stack exchange，提问作者Aleksandar Smilkovski