VS Code中Java连接MariaDB提示‘驱动未找到’问题排查

检查驱动包在VS Code中的配置 #

• 普通Java项目：
  1. 把mariadb-java-client-3.0.8.jar放到项目的lib目录下；
  2. 在VS Code资源管理器里右键该jar包，选择「Add to Build Path」。
• Maven项目：
  确保pom.xml中添加了正确依赖，然后执行mvn clean install刷新依赖：

  <dependency>
      <groupId>org.mariadb.jdbc</groupId>
      <artifactId>mariadb-java-client</artifactId>
      <version>3.0.8</version>
  </dependency>
  

代码中显式加载驱动 #

JDBC4.0+虽支持自动加载，但VS Code环境可能需要显式声明，在获取连接前添加驱动加载代码：

import java.sql.Connection;
import java.sql.DriverManager;

public class App {
    public static void main(String[] args) throws Exception {
        try {
            Class.forName("org.mariadb.jdbc.Driver"); // 显式加载驱动类
            Connection conn = DriverManager.getConnection("jdbc:mariadb://localhost:3306/cpit305-project", "root", "");
            System.out.println("working");
        } catch (Exception e) {
            System.err.println(e);
        }
    }
}

检查VS Code的Java项目配置 #

• 按Ctrl+,打开设置，搜索java.project.referencedLibraries，确认mariadb-java-client-3.0.8.jar的路径已正确加入列表；
• 重启VS Code，让配置生效。

验证驱动包完整性 #

重新下载mariadb-java-client-3.0.8.jar替换原有文件，排除包损坏导致的识别失败。

内容的提问来源于stack exchange，提问作者Mohammed Akif