java.sql.SQLExceptionの解決方法｜ローカルホストテストで「適切なドライバが見つかりません」となる原因と対策

「java.sql.SQLException: No suitable driver found for localhost（ローカルホストに適したドライバが見つかりません）」という例外は、指定したJDBC URLを、読み込まれているどのJDBCドライバもacceptsURL()メソッドで受け入れられなかった場合に必ず発生します。この記事では、エラーが起こる仕組みと、具体的な解決手順をわかりやすく解説します。

エラーが発生する仕組み

DriverManager.getConnection()が呼び出されると、Javaは登録済みのすべてのJDBCドライバに対し、そのURLを処理できるかどうかを問い合わせます。この判定を行っているのがacceptsURLメソッドです。すべてのドライバがfalseを返すと、「適切なドライバが見つからない」としてSQLExceptionがスローされます。

acceptsURLメソッドのプロトタイプは以下の通りです。

boolean acceptsURL(String url) throws SQLException

このメソッドはboolean型の値を返します。引数として渡されたデータベースURL（String型1個）をそのドライバが理解できる場合にはtrueを、理解できない場合にはfalseを返します。

MySQL JDBCドライバの準備

MySQLに接続する場合は、事前にMySQL Connector/J（MySQL JDBCドライバ）をプロジェクトに組み込んでおく必要があります。jarファイルをクラスパスに追加するか、MavenやGradleで依存関係として宣言しましょう。

Mavenを使用している場合の記述例：

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
</dependency>

MySQLのJDBC URL

MySQLのJDBC URLは以下の形式で指定します。

jdbc:mysql://localhost:3306/test?useSSL=false

「jdbc:mysql://」というプレフィックスが正しく指定されていないと、どのドライバもURLを受け付けず、本例外が発生します。

データベース接続の構文

接続全体は、以下のような構文で行います。

con = DriverManager.
getConnection("jdbc:mysql://localhost:3306/yourDatabaseName?useSSL=false", "yourUserName", "yourPassword");

サンプルコード

実際に動作するJavaコードの例は以下の通りです。

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

public class AvoidSQLException {
    public static void main(String[] args){
        Connection con = null;
        try {
            con = DriverManager.
            getConnection("jdbc:mysql://localhost:3306/sample?useSSL=false", "root", "123456");
            System.out.println("Connection is successful !!!!!");
        } catch(Exception e) {
            e.printStackTrace();
        }
    }
}

実行結果

上記のコードを実行すると、正常に接続できた場合はコンソールに次のように表示されます。

Connection is successful !!!!!

それでも解決しない場合のチェックポイント

• MySQL Connector/Jのjarファイルが、クラスパスまたはビルドツールの依存関係に正しく含まれているか確認する。
• JDBC URLが「jdbc:mysql://」で始まっているか確認する。他のDBMS用のURLになっていないか見直す。
• JDBCドライバのバージョンが、利用中のMySQLサーバーのバージョンと互換性があるか確認する。

これらの点を見直せば、「No suitable driver found for localhost」のエラーは確実に解消できます。