WSL Linux 24.02.1下Java18连接MySQL8.0.31提示无合适驱动求助

一、解决Class.forName的编译错误 #

你遇到的编译错误是因为代码位置违规。try-with-resources语法要求try关键字后紧跟(资源声明)，然后直接是代码块{}，不能在中间插入其他语句。正确写法有两种：

写法1：在try-with-resources前加载驱动（推荐） #

import java.sql.*;

public class TestApplication {
   static final String DB_URL = "jdbc:mysql://localhost/opiejbc1?serverTimezone=UTC"; // 添加时区参数
   static final String USER = "opiejbc1";
   static final String QUERY = "SELECT * FROM Test1";

   public static void main(String[] args) {
      try {
          // 显式加载MySQL驱动
          Class.forName("com.mysql.cj.jdbc.Driver");
          // 初始化连接与资源
          try(Connection conn = DriverManager.getConnection(DB_URL, USER, "");
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery(QUERY);) {
             // 读取结果集
             while (rs.next()) {
                // 注意：若Name是字符串类型，需用getString而非getInt
                System.out.print("Name: " + rs.getString("Name"));
                System.out.print(", Phone: " + rs.getInt("Phone"));
             }
          }
      } catch (ClassNotFoundException e) {
          e.printStackTrace();
      } catch (SQLException e) {
         e.printStackTrace();
      } 
   }
}

写法2：在try代码块开头加载驱动（不推荐，仅语法合法） #

// 其他代码不变
public static void main(String[] args) {
      try(Connection conn = DriverManager.getConnection(DB_URL, USER, "");
         Statement stmt = conn.createStatement();
         ResultSet rs = stmt.executeQuery(QUERY);) {
         // 此位置加载驱动已晚于getConnection调用，仅语法合法
         Class.forName("com.mysql.cj.jdbc.Driver");
         // 后续读取逻辑
      } catch (ClassNotFoundException | SQLException e) {
         e.printStackTrace();
      } 
   }

二、解决No suitable driver found错误 #

该错误核心是JVM找不到MySQL驱动类或JDBC URL格式错误，按以下步骤排查：

1. 修正JDBC URL格式
   MySQL 8.0版本必须指定时区参数，否则会触发驱动加载失败。修改URL为：

static final String DB_URL = "jdbc:mysql://localhost/opiejbc1?serverTimezone=UTC&useSSL=false";

（useSSL=false用于关闭本地测试时的SSL警告，可选）

2. 验证驱动jar的存在与权限

• 确认/usr/share/java/mysql-connector-j-8.0.31.jar文件存在，文件名完全匹配（Linux区分大小写）。
• 检查文件权限，确保当前用户可读取：

  ls -l /usr/share/java/mysql-connector-j-8.0.31.jar
  

  权限不足时执行：

  sudo chmod 644 /usr/share/java/mysql-connector-j-8.0.31.jar
  

3. 确保classpath生效
   执行程序时直接指定驱动jar路径，比依赖目录更可靠：

java -cp .:/usr/share/java/mysql-connector-j-8.0.31.jar TestApplication

三、额外注意事项 #

• 代码中rs.getInt("Name")大概率有误：若Name是字符串类型（如VARCHAR），必须使用rs.getString("Name")，否则会抛出SQL异常。
• 确认MySQL服务正在运行，且用户opiejbc1拥有opiejbc1数据库和Test1表的访问权限。

内容的提问来源于stack exchange，提问作者Jesse Brent Coats