JavaのClassNotFoundExceptionとNoClassDefFoundErrorの違いとは？原因と対処法を解説

Javaアプリケーションを実行する際、ClassNotFoundExceptionとNoClassDefFoundErrorはどちらも、JVMやクラスローダーが実行時に必要なクラスを見つけられない場合に発生するエラーです。しかし、この2つには重要な違いがあります。ClassNotFoundExceptionはチェック例外（checked exception）であるのに対し、NoClassDefFoundErrorは非チェックのErrorに分類されます。

Javaには複数種類のClassLoader（クラスローダー）が存在し、それぞれ異なるソースからクラスを読み込みます。ライブラリのJARファイルが欠落していたり、クラスパスの設定が誤っていたりすると、実行時にクラスをロードできず、これらのエラーが発生します。

ClassNotFoundExceptionとは

ClassNotFoundExceptionは、リフレクションを使って実行時にクラスを動的にロードしようとした際、そのクラスファイルが存在しない場合にスローされる例外です。クラスのロードは実行時に行われるため、コンパイル時にはその存在を確認できません。

コード例

public class ClassNotFoundExceptionTest {
    public static void main(String[] args) {
        try {
            Class.forName("Test");
        } catch (ClassNotFoundException cnfe) {
            System.err.println("存在しないクラスを検索しようとしています。" + cnfe);
        }
    }
}

実行結果

存在しないクラスを検索しようとしています。java.lang.ClassNotFoundException: Test

NoClassDefFoundErrorとは

NoClassDefFoundErrorは、コンパイル時にはクラスパス上に存在していたクラスが、実行時には利用できない場合にスローされるエラーです。最も基本的な原因はJARファイルの欠落です。Java APIドキュメントには「検索対象のクラス定義は、現在実行中のクラスのコンパイル時には存在していたが、その定義がもはや見つからない」と記載されています。

コード例

class Test1 {
    public void show() {
        System.out.println("show()メソッドが呼び出されました");
    }
}
public class Test2 {
    public static void main(String[] args) {
        Test1 t = new Test1();
        t.show();
    }
}

両方のクラスをコンパイルすると、Test1.classとTest2.classの2つのクラスファイルが生成されます。ここでTest2を実行する前にTest1.classファイルを削除すると、以下のようにNoClassDefFoundErrorが発生します。

実行結果

Exception in thread "main" java.lang.NoClassDefFoundError: Test1
        at Test2.main(Test2.java:9)

両者の違いまとめ

このように、ClassNotFoundExceptionはプログラム側で捕捉・回復できる例外である一方、NoClassDefFoundErrorは環境やビルド構成の問題を示すエラーであり、根本的な解決にはクラスパスや依存ライブラリの見直しが必要です。