VS Code中通过JDBC无法连接MySQL数据库问题排查咨询

核心问题解答 #

• Java连接MySQL不强制要求使用Maven项目。Maven只是依赖管理工具，作用是自动拉取、管理第三方依赖包，只要手动将对应版本的MySQL JDBC驱动包加入项目构建路径，普通Java项目完全可以正常连接数据库。

VS Code环境连接失败排查步骤 #

按优先级依次排查：

• 检查驱动是否正确引入
  非Maven项目需要手动下载对应MySQL版本的JDBC驱动jar包（mysql-connector-java），在VS Code资源管理器中右键jar包选择「Add to Build Path」，未完成这一步会直接报驱动类找不到的错误。
  注意版本匹配：MySQL 8.0及以上版本的驱动类名为com.mysql.cj.jdbc.Driver，你代码中写的com.mysql.jdbc.Driver仅适用于MySQL 5.1及更早版本，高版本用旧类名会直接连接失败。
• 检查数据库服务状态
  先通过命令行mysql -u root -p登录数据库，确认本地3306端口的MySQL服务正常启动，代码中填写的账号密码和实际一致。
• 修正JDBC连接URL
  高版本MySQL需要在连接URL中指定时区、关闭SSL等参数，同时需要明确指定要连接的数据库名，缺省参数会导致时区错误、SSL连接失败等问题。
• 检查VS Code Java环境配置
  确认已安装官方Java扩展包（Extension Pack for Java），项目配置的JDK版本和JDBC驱动支持的版本匹配，避免出现版本不兼容问题。

修正后的测试代码 #

package JDBC;
import java.sql.Connection;
import java.sql.DriverManager;

public class createDb {
    // MySQL 5.x版本请将驱动类替换为 com.mysql.jdbc.Driver
    private static final String DB_DRIVER = "com.mysql.cj.jdbc.Driver";
    // 请将URL中的test替换为你实际要连接的数据库名
    private static final String DB_URL = "jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true";
    private static final String DB_USERNAME = "root";
    private static final String DB_PASSWORD = "root";
    
    public static void main(String args[]) {
        Connection conn = null;
        try {
            Class.forName(DB_DRIVER);
            conn = DriverManager.getConnection(DB_URL, DB_USERNAME, DB_PASSWORD);
            if (conn != null) {
                System.out.println("Successfully connected.");
                conn.close();
            } else {
                System.out.println("Failed to connect.");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

非Maven项目手动导包操作流程 #

• 下载和本地MySQL版本匹配的JDBC驱动jar包
• 在项目根目录新建lib文件夹，将jar包放入该文件夹
• 右键jar包选择「Add to Build Path」，等待项目构建完成后即可运行代码

开发复杂项目时推荐使用Maven管理依赖，只需在pom.xml中添加驱动配置，无需手动下载导包、处理版本冲突，开发效率更高，但这属于效率优化手段，不是连接数据库的必要前提。

内容的提问来源于stack exchange，提问作者Vaibhav Pawar