JavaのUnsupportedClassVersionError: Unsupported major.minor versionの例と解説

2024-08-19

エラーメッセージの意味:

java.lang.UnsupportedClassVersionError: Unsupported major.minor version というエラーは、Javaプログラムの実行時に発生します。
このエラーは、クラスファイルがコンパイルされたJavaのバージョンと、プログラムを実行しているJavaのバージョンが異なる場合に起こります。
コンパイル時のJavaバージョンが実行時のバージョンよりも新しい場合、このエラーが発生します。

原因:

異なるJavaバージョン: プログラムのコンパイルに使用したJavaのバージョン（JDK）と、プログラムを実行するために使用するJavaのバージョン（JRE）が一致していない。
古いJRE: 使用しているJREが古く、新しいバージョンのクラスファイルをサポートしていない。

解決方法:

実行環境のJavaバージョンを確認する:
コンパイル環境と実行環境のバージョンを合わせる:
- コンパイルに使用したJavaのバージョンと実行環境のJavaのバージョンが同じであることを確認します。
- コンパイル環境のバージョンを変更するか、実行環境のバージョンをアップグレードします。
古いJavaバージョンの場合:
- 古いJavaバージョンを使用している場合、可能な限り新しいバージョンにアップグレードすることを推奨します。
- アップグレードできない場合は、プログラムを古いJavaバージョンで再コンパイルする必要があります。

追加情報:

major.minor version: エラーメッセージには major.minor version の数値が表示されます。これは、クラスファイルがコンパイルされたJavaバージョンの情報を示しています。
JDKとJRE: JDK (Java Development Kit) は開発用のツールセットで、JRE (Java Runtime Environment) はプログラムの実行に必要な環境です。

注意:

Javaのバージョンには互換性がありますが、古いバージョンでコンパイルされたクラスファイルを新しいバージョンで実行できる場合でも、パフォーマンスや機能制限が発生する可能性があります。
可能な限り、プログラムのコンパイルと実行に同じJavaバージョンを使用することを推奨します。

例:

クラスファイルがJava 17でコンパイルされ、Java 8のJREで実行しようとした場合、このエラーが発生します。
この場合、Java 17のJREを使用するか、クラスファイルをJava 8で再コンパイルする必要があります。

Javaのバージョンや環境によって、解決方法が異なる場合があります。
可能な限り、最新のJavaバージョンを使用することを推奨します。

JavaのUnsupportedClassVersionError: Unsupported major.minor versionの例と解説

エラーの原因を再確認

このエラーは、JavaのクラスファイルがコンパイルされたJavaのバージョンと、実行時に使用しているJavaのバージョンが異なる場合に発生します。つまり、クラスファイルが実行環境のJavaバージョンで理解できないということです。

例コードと解説

例1: 異なるバージョンのJDKでコンパイルと実行

// Java 17でコンパイルされたクラス
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

このクラスファイルをJava 8のJREで実行しようとすると、以下のようなエラーが発生します。

Error: Could not find or load main class HelloWorld
Caused by: java.lang.UnsupportedClassVersionError: Unsupported major.minor version 52.0

解説:

major.minor version 52.0 はJava 17に対応する値です。
Java 8のJREはJava 17のクラスファイルの形式を理解できないため、エラーが発生しています。

例2: ビルドツール(Maven, Gradle)の設定

<project>
  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>
  </proj   ect>

// build.gradle (Gradle)
java {
    toolChain {
        languageVersion = JavaVersion.VERSION_17
    }
}

MavenやGradleなどのビルドツールでは、コンパイルするJavaのバージョンを指定できます。
上記の設定は、Java 17でコンパイルすることを意味します。
実行環境のJavaバージョンもJava 17に合わせる必要があります。

解決策

実行環境のJavaバージョンを確認:
- java -version コマンドで確認します。
コンパイル環境と実行環境のバージョンを合わせる:
- コンパイル時のJavaバージョンと実行時のJavaバージョンが一致するようにします。
- ビルドツールの設定や、JDKのバージョンを変更します。
古いJavaバージョンの場合:
- 可能であれば、新しいJavaバージョンにアップグレードします。