HOWTO · Java

Java.Lang.NoClassDefFoundError: クラス エラーを初期化できませんでしたを修正します。

このチュートリアルでは、java.lang.noclassdeffounderror: could not initialize class エラーについて説明し、考えられる理由を説明し、解決策を示します。

このページの内容

このエラーは通常、同じ JVM 内で、それ以前にクラスの静的初期化が失敗したことを示します。最初にクラスを使用したときは java.lang.ExceptionInInitializerError が報告されることが多く、その後、同じクラスローダーでそのクラスを再び使用しようとすると、java.lang.NoClassDefFoundError: Could not initialize class が報告されることがあります。最初の失敗を見つけて修正してください。後から表示されるメッセージは、多くの場合、元の原因ではなくその結果です。

これは、コードがクラス名を指定して明示的に読み込もうとしたものの、見つからなかったことを意味する java.lang.ClassNotFoundException とは異なります。クラス定義が見つからない場合も、特定のクラスが見つからないことを示す別の形式の NoClassDefFoundError が発生することがあります。「Could not initialize class」という文言は初期化状態を示します。JAR の追加やクラスパスの変更が役立つのは、最初の失敗が依存関係の不足を実際に示している場合に限られます。

NoClassDefFoundError: Could not initialize class の意味

JVM がクラスを初期化するとき、静的フィールドの初期化子と静的初期化ブロックを実行します。その処理に失敗すると、JVM はそのクラスローダー内でクラスをエラー状態として記録します。同じクラスローダーで後からそのクラスを使用しても初期化子は再実行されず、NoClassDefFoundError が発生することがあります。プロセスを再起動すれば初期化を新たに試みられますが、根本的な不具合は解消されません。

よくあるきっかけとして、静的初期化子が作業ディレクトリからの相対パスでファイルを読み込むこと、不正な設定を解析すること、利用できないサービスにアクセスすること、失敗する依存関係を呼び出すことが挙げられます。そのため、開発者のマシンでは動作するコードが、作業ディレクトリ、ファイル権限、環境変数、依存関係の構成が異なるサーバーでは失敗する場合があります。これらは調査対象となる可能性であり、すべてのエラーに当てはまる原因の一覧ではありません。

明示的にアプリケーションを起動するときに実行できるのであれば、静的初期化で壊れやすい処理や環境に依存する処理を行わないでください。初期化に失敗する場合は、原因を保持し、該当する設定やリソースを特定できるだけの情報を報告してください。

静的初期化子で失敗を再現する

この小さなプログラムは、最初の初期化失敗を発生させた後、同じクラスをもう一度使用します。2回目の試行を見ると、後続のエラーによって元の例外という重要な情報が隠れることがある理由がわかります。

このセクションのコードと表示されるラベルや出力は英語のままです。

public class InitializationFailure {
  static class Settings {
    static {
      if (Boolean.parseBoolean("true")) {
        throw new IllegalStateException("configuration is missing");
      }
    }

    static void load() {
      System.out.println("settings loaded");
    }
  }

  public static void main(String[] args) {
    try {
      Settings.load();
    } catch (Throwable error) {
      System.out.println(error.getClass().getName());
      if (error.getCause() != null) {
        System.out.println(error.getCause());
      }
    }

    try {
      Settings.load();
    } catch (Throwable error) {
      System.out.println(error.getClass().getName());
    }
  }
}

出力は次のとおりです。

java.lang.ExceptionInInitializerError
java.lang.IllegalStateException: configuration is missing
java.lang.NoClassDefFoundError

最初の呼び出しでは、初期化子の失敗とその原因が報告されます。2回目の呼び出しでは、同じ JVM とクラスローダー内ですでに Settings が失敗状態として記録されていることがわかります。エラーメッセージの正確な文言は Java の実装によって異なることがあるため、この例では VM 固有のメッセージに依存せず、例外クラス名と最初の原因を出力します。

アプリケーションでは、PropHolder のようなプロパティ保持クラスが、静的フィールドの初期化子でファイルを読み込むことがあります。ある環境でそのファイルが存在しない、読み取れない、または形式が正しくない場合、最初の失敗によって、そのプロセスが終了するまでクラスが使用できなくなることがあります。相対パスはプロセスの作業ディレクトリを基準に解決されます。このディレクトリは IDE、サービス管理ツール、コンテナー、コマンドシェルで異なる場合があります。これは確認すべき具体例の一つです。該当するかどうかはスタックトレースで判断してください。

最初の初期化失敗を見つける

最後に表示された NoClassDefFoundError だけでなく、影響を受けたプロセスでそのクラスについて記録された最も早いログエントリーを確認してください。ログ全体から ExceptionInInitializerError、クラス名、最初の Caused by: エントリーを検索します。最初の例外とスタックフレームから、失敗した初期化子と処理を特定できることがよくあります。

その情報を使って、関係する入力を具体的に確認してください。

  • ファイルを読み込む場合は、失敗した環境で解決されたパス、プロセスの作業ディレクトリ、ファイルの有無、権限、エンコーディング、内容を確認します。
  • 設定を解析する場合は、実際の値を調べ、解析できなかった設定項目を報告します。
  • 依存関係を呼び出す場合は、その依存関係自身の原因、実行時のバージョン、起動時に必要なサービスを利用できるかを確認します。
  • 初期化順序や循環参照が疑われる場合は、互いを参照する静的フィールドを調べ、初期化途中の状態に依存しないようにします。

「クラス」という語だけを根拠に、クラスパスの問題だと決めつけないでください。最初の原因にクラスやメソッドの不足が示されている場合は、実行時の依存関係とバージョンの整合性を調べます。そうでなければ、最初の原因が示す処理を修正してください。ログに後続のエラーしかない場合は、起動時のログを有効にするか、新しい JVM を起動する対象を絞ったテストで問題を再現します。失敗したクラスは、既存のクラスローダー内で安全にリセットできません。

初期化子を修正し、アプリケーションを検証する

失敗した入力や処理を修正してください。たとえば、設定済みの安定した場所にプロパティファイルを用意する、偶然の作業ディレクトリに頼らず明示的なパスを使う、起動時に必須の値を検証する、リソース名や設定名を含む明確なエラーを報告する、といった方法があります。値が実行時の設定に依存する場合は、呼び出し元に役立つエラーを返せる明示的な初期化メソッドを優先してください。

初期化例外を捕捉して、値が null または不完全なまま処理を続けないでください。そうすると最初の原因が隠れ、アプリケーションが安全でない状態で残ります。アプリケーションで代替値が有効なら、その値を意図的に定義して検証してください。そうでなければ、元の原因を付けて起動に失敗させます。

原因を修正したら、新しいプロセスを起動し、対象クラスの初期化と、そのクラスを使うアプリケーションの処理が両方とも成功することを確認してください。静的初期化が成功する簡単な例を示します。

このセクションのコードと表示されるラベルや出力は英語のままです。

public class InitializationCheck {
  static class Settings {
    static final String MODE = "ready";
  }

  public static void main(String[] args) {
    System.out.println(Settings.MODE);
  }
}

出力は次のとおりです。

ready

続いて、問題が発生した環境でも、同じサービスアカウント、作業ディレクトリ、設定、実行時の依存関係を使って確認してください。再起動だけでも一時的に症状が消えることがあります。確実な検証では、意図した設定のもとで、最初に失敗した処理が今度は成功することを確認します。