So beheben Sie java.lang.UnsupportedClassVersionError: Vollständiger Leitfaden

Einleitung: Eine "Zeitmaschine" für Ihren Java-Code

Stellen Sie sich vor: Sie haben eine tolle Bibliothek heruntergeladen, ein paar Zeilen Code geschrieben, drücken auf "Run" – und statt eines funktionierenden Programms sehen Sie eine lange, beängstigende Meldung:

Exception in thread "main" java.lang.UnsupportedClassVersionError: \ncom/example/MyApp has been compiled by a more recent version of the Java Runtime \n(class file version 61.0), this version of the Java Runtime only recognizes \nclass file versions up to 55.0

Kommt Ihnen bekannt vor? Wenn Sie jemals auf java.lang.UnsupportedClassVersionError gestoßen sind, wissen Sie, dass es sich anfühlt wie ein Gespräch zwischen zwei Menschen, die verschiedene Sprachen sprechen. Ihr Java-Programm spricht Version 61.0 (Java 17), aber die Laufzeitumgebung versteht nur bis Version 55.0 (Java 11).

In diesem Tutorial erklären wir, was Unsupported major.minor version ist, warum sie auftritt und – am wichtigsten – wie man sie behebt. Wir geben nicht nur fertige Lösungen, sondern bringen Ihnen bei, die Ursache des Problems zu verstehen. Los geht's!

Was ist die major.minor version? Eine kurze Einführung

Jede .class-Datei in Java hat eine interne Kennzeichnung – die major.minor version. Dies ist die Versionsnummer des Bytecode-Formats, das vom Compiler javac erstellt wird. Zum Beispiel:

\n
• major 52 → Java 8
\n
• major 55 → Java 11
\n
• major 61 → Java 17
\n
• major 65 → Java 21
\n

Wenn Sie eine Anwendung starten, prüft die JRE (Java Runtime Environment), ob sie diese Datei "verstehen" kann. Ist die Version der Datei neuer als die Version der JRE, erhalten Sie java.lang.UnsupportedClassVersionError.

Eine einfache Analogie: Stellen Sie sich vor, Sie versuchen, ein PDF-Dokument, das mit Adobe Acrobat 2023 erstellt wurde, in Adobe Reader 2010 zu öffnen. Das Programm wird sagen: "Ich kenne dieses Format nicht."

Hauptursachen für den Fehler UnsupportedClassVersionError

Der Fehler Unsupported major.minor version kann aus mehreren Gründen auftreten:

\n
• Unterschiedliche JDK- und JRE-Versionen: Sie haben den Code mit JDK 17 kompiliert, führen ihn aber mit JRE 11 aus.
\n
• Bibliotheken von Drittanbietern: Sie haben eine JAR-Datei eingebunden, die für Java 17 kompiliert wurde, aber Ihre Laufzeitumgebung ist Java 8.
\n
• Falsche Maven/Gradle-Konfiguration: In der Build-Datei ist eine Java-Version angegeben, auf dem Server ist jedoch eine andere installiert.
\n
• Bereitstellung auf einem alten Server: Sie entwickeln in einer modernen IDE, aber der Produktionsserver läuft mit einer veralteten Java-Version.
\n

Schritt-für-Schritt-Tutorial: So beheben Sie den Fehler

Lassen Sie uns konkrete Schritte zur Lösung des Problems durchgehen. Wir betrachten drei Hauptszenarien.

Schritt 1: Überprüfen Sie die Java-Versionen

Als Erstes müssen Sie herausfinden, wer "schuld" ist. Öffnen Sie ein Terminal und führen Sie Folgendes aus:

# Version, mit der Sie kompilieren (JDK)\njavac -version\n\n# Version, mit der Sie ausführen (JRE)\njava -version

Wenn diese nicht übereinstimmen – das ist die Ursache. Zum Beispiel zeigt javac "17.0.1" und java "11.0.12".

Lösung: Installieren Sie identische Versionen, aktualisieren Sie entweder die JRE oder senken Sie die Kompilierungsversion ab (dazu weiter unten).

Schritt 2: Korrigieren Sie die Kompilierungseinstellungen

Wenn Sie die JRE nicht aktualisieren können (z. B. auf einem Server), müssen Sie den Code für eine ältere Version kompilieren. Verwenden Sie die Flags -source und -target im Compiler:

// Kompilieren Sie Java-17-Code, generieren Sie aber Bytecode für Java 11\njavac -source 17 -target 11 MyApp.java

Wichtig: -source gibt an, welche Java-Syntax Sie verwenden, und -target gibt an, für welche JRE-Version die .class-Datei generiert werden soll. Wenn Ihr Code Funktionen von Java 17 verwendet (z. B. switch-Ausdrücke), werden diese in kompatiblen Bytecode kompiliert.