Gradle依赖引入MySQL JDBC Driver无效问题求助

1. 确认build.gradle的依赖配置正确 #

检查你的build.gradle里的依赖块，确保MySQL驱动的声明放在正确位置。驱动属于运行时依赖，用runtimeOnly更合适，用implementation也能正常工作：

dependencies {
    runtimeOnly 'mysql:mysql-connector-java:8.0.32'
    // 若需要编译时访问驱动类，替换为下面这句
    // implementation 'mysql:mysql-connector-java:8.0.32'
}

改完后执行./gradlew clean build，确保依赖被正确拉取到本地。

2. 用Gradle的run任务启动程序，不要用VSCode默认Java运行按钮 #

VSCode自带的Java运行功能可能不会自动读取Gradle管理的依赖，需通过Gradle的run任务启动：

• 先安装VSCode官方的「Gradle for Java」插件，左侧会出现Gradle面板
• 展开你的项目，找到Tasks > application > run，点击运行图标即可
• 或者直接在终端执行命令：

./gradlew run

这样Gradle会自动将所有依赖（包括MySQL驱动）加入类路径，避免找不到类的问题。

3. 可移除不必要的Class.forName调用 #

MySQL Connector/J 8.0+ 支持JDBC 4.2规范的SPI自动加载，无需手动调用Class.forName("com.mysql.cj.jdbc.Driver")，直接编写连接代码即可：

String dbUrl = "jdbc:mysql://localhost:3306/你的数据库名?useSSL=false&serverTimezone=UTC";
String dbUser = "你的用户名";
String dbPwd = "你的密码";
try (Connection conn = DriverManager.getConnection(dbUrl, dbUser, dbPwd)) {
    // 编写数据库操作逻辑
} catch (SQLException e) {
    e.printStackTrace();
}

若一定要保留Class.forName，需确认类名拼写正确——是com.mysql.cj.jdbc.Driver（旧版com.mysql.jdbc.Driver在8.0中已废弃）。

4. 检查VSCode的Java类路径配置 #

如果以上方法无效，打开VSCode命令面板（Ctrl+Shift+P），输入Java: Configure Classpath，查看是否包含mysql-connector-java-8.0.32.jar。也可在终端执行./gradlew dependencies，查看依赖树确认驱动已被正确引入。

内容的提问来源于stack exchange，提问作者Samuel Kuta