JavaのClassNotFoundExceptionを徹底解説！初心者でもわかる原因と解決方法

ClassNotFoundExceptionクラス

先生と生徒の会話形式で理解しよう

生徒

「Javaでプログラムを実行したら、ClassNotFoundExceptionっていうエラーが出たんですが、これは何なんでしょうか？」

先生

「それはJavaのクラスが見つからないときに発生する例外です。パッケージはjava.langに含まれていて、よく遭遇するエラーのひとつです。」

生徒

「どういうときに発生するんですか？」

先生

「クラスパスに必要なクラスが含まれていないときや、外部ライブラリを読み込めていないときなどに発生します。詳しく見ていきましょう！」

1. ClassNotFoundExceptionとは

JavaのClassNotFoundExceptionは、指定されたクラスがクラスローダーによって見つからなかったときに発生するチェック例外です。Javaプログラムを動かすときに頻繁に遭遇する例外のひとつで、特に外部ライブラリやフレームワークを使う場面で発生しやすいです。Java初心者がSpringやJakartaEE、Hibernateなどを学習しているときによく直面するため、原因と解決方法を理解しておくことが大切です。

2. 発生する典型的なケース

ClassNotFoundExceptionが発生するのは、主に以下のようなケースです。

外部ライブラリ（JARファイル）がクラスパスに含まれていない
Class.forNameで指定したクラス名が誤っている
Webアプリケーションで依存関係の設定ミスがある
ビルドツール（GradleやMaven）の設定が不完全

特にJavaでデータベース接続を行うときに「JDBCドライバクラスが見つからない」という形で発生するのが代表例です。

3. サンプルコードで理解しよう

次のコードは、Class.forNameでJDBCドライバをロードしようとして、クラスが見つからない場合にClassNotFoundExceptionが発生する例です。


public class DatabaseLoader {
    public static void main(String[] args) {
        try {
            Class.forName("com.mysql.cj.jdbc.Driver");
            System.out.println("ドライバのロードに成功しました。");
        } catch (ClassNotFoundException e) {
            System.out.println("クラスが見つかりません: " + e.getMessage());
        }
    }
}


クラスが見つかりません: com.mysql.cj.jdbc.Driver

この場合、MySQLのJDBCドライバがクラスパスに含まれていないためにエラーが発生しています。

4. 解決方法

ClassNotFoundExceptionを解決するには、以下のポイントを確認します。

必要なJARファイルをクラスパスに追加する
GradleやMavenの依存関係を正しく設定する
クラス名の指定に誤りがないか確認する
WebアプリケーションではWEB-INF/libにライブラリが配置されているか確認する

例えばGradleでMySQLドライバを利用する場合は、次のようにbuild.gradleに依存関係を追加します。


dependencies {
    implementation 'mysql:mysql-connector-java:8.0.33'
}

この設定を加えることで、Gradleが自動的にJARをダウンロードし、クラスパスに追加してくれます。

5. java.langパッケージとの関係

ClassNotFoundExceptionはjava.langパッケージに含まれています。java.langパッケージは、Javaプログラムで常に利用可能な基本的なクラス群を提供しており、特別にインポートしなくても使用できます。Objectクラス、Stringクラス、Mathクラスなどと同様に、例外クラスも多数含まれています。

ClassNotFoundExceptionはExceptionクラスを継承したチェック例外なので、try-catchで処理する必要があります。Javaの基本構造を学ぶ際には、例外処理の基礎と一緒に理解すると効率的です。