Javaの「メインクラスが見つからない、またはロードできません」エラーの原因と解決方法

Javaでは、コードの実行は事前にコンパイルされたクラスを通じて行われます。Javaでクラスを記述すると、コンパイラが高水準のソースコードを「バイトコード」と呼ばれる低水準のコードに変換します。記述した各クラスに対して、コンパイル済みのバイトコードが生成され、このバイトコードにはJava仮想マシン（JVM）上で実行可能な低レベルのコードが含まれています。

しかし、ターミナルでjavaコマンドを実行した際に、「could not find or load main class（メインクラスが見つからない、またはロードできませんでした）」というようなエラーが表示されることがあります。これはクラスのバイトコードに何らかの問題があることを示しています。では、どのように修正すればよいのでしょうか。本記事で詳しく解説します。

「could not find or load main class」エラーとは？

could not find or load main classというエラーは、コードの構成に何らかの問題があることを示しています。通常、次のようなコマンドをターミナルで実行してJavaプログラムを起動しようとした際に発生します。

java Test

ここでの「Test」は、実行したいコードを含むクラス名です。could not find or load main classエラーが表示された場合、Testクラスのバイトコードが見つからなかったことを意味します。

「could not find or load main class」エラーの解決方法

このエラーを解決する方法はいくつかあります。以下に、could not find or load main classエラーを特定・修正するための主な方法を紹介します。

1. タイプミスを確認する

このエラーの最初の原因として考えられるのは、入力ミスです。プログラム実行コマンドの構文は「java」とクラス名という2つのキーワードだけで構成されているため、間違いが起こりうるのはクラス名の部分だけです。もし「java」キーワード自体を誤入力した場合は、コマンドラインに明確な「command not found（コマンドが見つかりません）」というエラーが表示されます。

まずはクラス名に入力ミスがないか、再度確認してみましょう。多くの場合、この種のエラーは単純なスペルミスや打ち間違いが原因です。

例えば、「Test.java」というファイルに「Test」というクラスを記述した場合、通常は次のようにコマンドラインからコンパイルします。

javac Test.java

その後、次のコマンドでプログラムを実行します。

java Test

これで問題なくプログラムが実行されるはずです。しかし、上記のコマンドで「Test」のスペルを間違えると、Could not find or load main classエラーが発生する可能性があります。

2. アプリケーションのクラスパス設定を確認する

アプリケーションのクラスパス（CLASSPATH）に起因するケースも複数あります。クラスパスは、システム内でユーザークラスが保存されている場所を指す環境変数です。クラスパスが示すディレクトリには、コードに直接インポートできる既存のクラスが多数格納されています。

例えば、次のようなインポート文を記述したとします。

import org.company.Foo;

これを実行すると、JVMは<classpath>/org/company/Foo.javaという場所で「Foo」クラスを探します。ご覧のとおり、クラスパスが誤ったアドレスを指していると、JVMは目的のクラスを見つけることができず、could not find or load main classエラーをスローすることになります。

また、クラスパスにプログラムが依存するすべてのシステムクラスが含まれていない場合もあります。これは、まだダウンロードやセットアップを行っていないパッケージのクラスを読み込もうとしている可能性があります。この場合も同様に、このエラーが発生します。

3. クラスが誤ったパッケージで宣言されていないか確認する

ソースコードファイルの先頭に記述されたpackage文が、実際にクラスが宣言されているパッケージ／モジュールと一致していない場合も、このエラーの原因となります。ほとんどのIDEはリント（静的解析）機能によってこの問題を簡単に検出してくれますが、見落としてしまうと前述のエラーが発生します。

この問題への最善の対策は、常にクラスのパッケージ名が正しいパッケージを指しているかどうかを確認することです。IntelliJ IDEAやVS Codeのような高度なIDEを使用している場合は、この問題を検出するためのリント機能を有効にしておきましょう。

例えば、project/src/com/foo/barに保存された次のクラスを見てみましょう。

package com.foo.baz;
class Bar {
  // ここにコードを記述
}

この例では、package文はcom/foo/bazを指していますが、クラスは実際にはcom/foo/barに保存されています。これを修正するには、package文を正しいパッケージを指すように更新します。

package com.foo.bar;
class Bar {
  // ここにコードを記述
}

まとめ

本記事では、JavaにおけるCould not find or load main classエラーとは何か、そしてなぜ発生するのかについて解説しました。さらに、このエラーを修正するための代表的な方法として、タイプミスの確認、クラスパスの見直し、パッケージ宣言のチェックを紹介しました。

Javaでプログラムを作成していると、このエラーには時折遭遇することがあります。エラーメッセージ自体は少し intimidating（威圧的）に見えるかもしれませんが、解決はそれほど難しくありません。必要なのは、目的のクラスが正しい場所に存在するかどうかを確認することだけです。