开发Minecraft插件连接MariaDB时遇No suitable driver found错误求助

核心原因 #

该错误本质是JVM无法找到MariaDB专属的JDBC驱动类——MySQL驱动与MariaDB驱动不通用，即便协议兼容，类路径中也必须存在MariaDB的官方驱动。

分步解决方案 #

1. 引入正确的MariaDB JDBC驱动 #

• 若使用构建工具（Maven/Gradle），直接添加依赖：
  • Maven：

    <dependency>
        <groupId>org.mariadb.jdbc</groupId>
        <artifactId>mariadb-java-client</artifactId>
        <version>3.3.3</version> <!-- 适配MariaDB 11.0.2的最新稳定版，可按需更新 -->
        <scope>provided</scope> <!-- 插件开发建议用provided，避免与服务端依赖冲突 -->
    </dependency>
    

  • Gradle：

    compileOnly 'org.mariadb.jdbc:mariadb-java-client:3.3.3'
    

• 手动导入：下载对应版本的MariaDB JDBC驱动jar包，放入插件的lib目录（Spigot/Bukkit插件需确保jar被打包进插件，或放置在服务端的plugins/libs目录下）。

2. 修正连接代码 #

确保代码中使用MariaDB的驱动类，可显式加载避免类路径问题（JDBC4.0+支持自动加载，但显式加载更稳妥）：

try {
    // 加载MariaDB专属驱动类，而非MySQL的com.mysql.cj.jdbc.Driver
    Class.forName("org.mariadb.jdbc.Driver");
    Connection conn = DriverManager.getConnection(
        "jdbc:mariadb://172.17.0.1:3306/s1_users",
        "你的数据库用户名",
        "你的数据库密码"
    );
    // 后续数据库操作
} catch (ClassNotFoundException | SQLException e) {
    e.printStackTrace();
}

3. 检查服务端类路径与依赖冲突 #

• 不要同时在类路径中放置MySQL和MariaDB驱动，避免驱动加载混乱。
• 若将驱动放在服务端plugins/libs目录，需重启服务端让类路径生效。

4. 验证MariaDB服务与网络连通性 #

• 确认172.17.0.1:3306可被插件所在服务器访问，检查防火墙/安全组是否拦截3306端口。
• 使用MariaDB客户端测试连接：mariadb -h 172.17.0.1 -P 3306 -u 用户名 -p s1_users，确保数据库存在且账号拥有访问权限。

常见避坑点 #

• 驱动版本匹配：MariaDB 11.0.2建议使用3.2.x及以上版本的驱动，避免版本不兼容导致的隐性问题。
• 不要依赖MySQL驱动替代：即便部分场景能临时工作，长期来看会引发兼容性和稳定性问题。

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