HOWTO · Java
Java はクラス org.codehaus.groovy.vmplugin.v7.java7 を初期化できませんでした
このチュートリアルでは、Java でクラス org.codehaus.groovy.vmplugin.v7.java7 を初期化できませんでしたというエラーを示します。
このページの内容
メッセージ Could not initialize class org.codehaus.groovy.vmplugin.v7.java7 は、Java が Groovy の Java 7 仮想マシンプラグインの初期化を完了できなかったことを示します。これは症状であり、原因の特定ではありません。このメッセージだけでは、Gradle が見つからないことも、Java と Groovy の互換性に問題があることも、インストールが破損していることも分かりません。Gradle ビルドでは、まず失敗したコマンドが実際に使用している Java ランタイムと Gradle ディストリビューションを確認してください。プロジェクトの Wrapper を変更するのは、確認した証拠と各バージョンの互換性要件が変更を裏付ける場合に限ります。
このエラーが示すこと
org.codehaus.groovy.vmplugin.v7.Java7 は、このプラグインに関連する正確なクラス名です。報告されたエラーの小文字の java7 は、初期化エラーの表示方法による可能性がありますが、それだけで根本原因が分かるわけではありません。クラスの初期化エラーは、依存関係の読み込み中または初期化中に起きた先行エラーに続いて発生することがあります。多くの場合、手掛かりになるのは Gradle が最後に表示した行だけではなく、最初の例外と、その内側にある Caused by のメッセージです。
Gradle は内部で Groovy を使用するため、プロジェクトのコードが実行される前にこのエラーが発生することがあります。調査対象としては、ビルドで選択された Java ランタイム、Gradle のバージョンと同梱の Groovy、依存関係やクラスパスの問題などが考えられます。これらは原因と決めつけず、調査の手掛かりとして扱ってください。このメッセージだけを根拠に、グローバルな CLASSPATH を変更したり、Groovy を再インストールしたり、Java をアップグレードしたりしないでください。まず、以下の手順でバージョンと失敗の詳細を確認します。
ビルドが使用する Java と Gradle を確認する
失敗が発生するのと同じディレクトリ、シェル、コンテナー、IDE のターミナル、または CI ジョブで確認してください。java -version が表示するのは、そのシェルの PATH で見つかった Java コマンドの情報です。IDE やビルドサービスで設定されたランタイムとは異なる場合があります。プロジェクトに Gradle Wrapper が含まれている場合は、Wrapper のバージョンコマンドを使って、Wrapper が報告するディストリビューションと JVM を確認してください。
次の例を実行します。
このセクションのコードと表示されるラベルや出力は英語のままです。
public class Main {
public static void main(String[] args) {
System.out.println("Java runtime: " + System.getProperty("java.version"));
}
}
Java runtime: 17.0.20.1
このソースは、調査対象の Java インストールで実行することを想定しています。出力はそのランタイムによって異なります。表示されるのはこのプログラムを実行している JVM であり、別プロセスである Gradle の JVM ではありません。Gradle の JVM を調べるには、Wrapper のバージョンレポートを使用してください。
値がない、または空白の場合も想定しておく必要があります。これを Java のバージョンと解釈したり、値を推測したりしないでください。この単独の例では、その分岐を示すため診断値を空白にしています。
public class Main {
public static void main(String[] args) {
String javaVersion = "";
if (javaVersion == null || javaVersion.trim().isEmpty()) {
System.out.println("Java runtime: unavailable");
} else {
System.out.println("Java runtime: " + javaVersion);
}
}
}
Java runtime: unavailable
自分の診断コードでは、空白の値をソースが実際に返す値に置き換えてください。ソースが値を返さない場合があるなら、値を取得できない場合の分岐を残します。診断値がないことは、実行中の JVM にバージョンが存在しないことを意味しません。
Unix 系のシェルでは ./gradlew --version を、Windows では gradlew.bat --version を実行します。これらのコマンドはプロジェクトの Wrapper を使用します。別途インストールされた gradle --version が報告するのはシステムの Gradle であり、失敗したビルドを Wrapper で開始した場合の代わりにはなりません。また、失敗した Wrapper タスクそのものの出力を、最初の例外とすべての Caused by 行を含めて記録してください。
Gradle が実際に使用した Java ランタイムを、その Gradle リリースでサポートされている Java バージョンとGradle 公式の Java 互換性表で照合します。バージョン番号だけでは、互換性がないことも修正方法も確定できません。このビルドで使われているバージョンの要件を確認してください。IDE や CI ランナーで設定した JDK を使って Gradle を起動している場合は、シェルでの java -version に加え、その設定も確認します。
Gradle Wrapper を更新する
Wrapper は、プロジェクトで使用する Gradle ディストリビューションを固定します。gradle/wrapper/gradle-wrapper.properties と、その中の distributionUrl を確認してください。この URL は、Wrapper がダウンロードまたは使用するディストリビューションを示します。クラス名に Java 7 とあることや、システムの Gradle とバージョンが異なることだけを理由に Wrapper を編集しないでください。
互換性の確認により、Wrapper が指定する Gradle リリースが、Java ランタイムまたはビルドの文書化された要件をサポートしていないと分かった場合は、それらの要件を満たす Gradle リリースを選びます。プロジェクトで通常使っている Gradle のアップグレード手順で Wrapper を更新するか、Wrapper のタスクを実行できない場合は gradle-wrapper.properties のディストリビューションのバージョンを慎重に変更してください。変更はプロジェクト内に限定し、チームの通常の依存関係管理方針に沿って確認します。適切なバージョンは実際の Java ランタイムとビルドによって異なります。このエラーだけではバージョンを決められません。
エラーが続く場合
バージョンを確認したら、同じ Wrapper タスクを再実行し、最初に発生したエラー全体を保存します。トレースの中で、最も早く現れる関連性のある原因を追ってください。クラスが見つからない、または競合していると示されている場合は、そのビルドの依存関係やクラスパスの情報を調べます。キャッシュされたアーティファクトの破損が示されている場合は、ビルドでサポートされているキャッシュ更新または依存関係の再解決手順を使い、その後のトレースを比較します。Gradle は独自の Groovy ランタイムを提供するため、Gradle ビルドでは通常、Groovy の単独再インストールを最初に試す必要はありません。
特に CI やマルチモジュールリポジトリでは、失敗したタスクが想定したプロジェクトのチェックアウトと Wrapper ファイルを使用していることを確認してください。失敗する環境と動作する環境で、作業ディレクトリ、Wrapper スクリプト、gradle-wrapper.properties、Java の選択を比較します。複数の環境変数やバージョンを一度に変更すると、どの条件が関係していたか判断しにくくなります。最初の原因から有力な原因を特定できない場合は、トレースを保存してその原因を調査し、最後に表示されたプラグインのクラス名だけを根拠に結論づけないでください。
修正を確認する
失敗したときと同じ Wrapper コマンド、同じ環境で、最初に失敗したタスクを再実行します。次に ./gradlew --version または gradlew.bat --version を再度実行し、報告された Gradle ディストリビューションと JVM が、確認しようとしているバージョンと一致することを確かめます。バージョンレポートが正常に表示されるだけでは、元のビルドが修正された証拠にはなりません。元のタスクが初期化エラーなしで完了する必要があります。
それでも失敗する場合は、新しい最初の例外と、その内側にある原因を保存したトレースと比較します。その結果は、試した変更では確認された失敗を解決できず、さらに診断が必要であることを示します。問題を表面化させた同じタスクが成功するまでは、修正済みと報告しないでください。