Comment corriger java.lang.UnsupportedClassVersionError : Guide complet

Introduction : "Machine à voyager dans le temps" pour votre code Java

Imaginez : vous avez téléchargé une super bibliothèque, écrit quelques lignes de code, vous appuyez sur "Run" — et au lieu d'un programme fonctionnel, vous voyez un long message effrayant :

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

Familiar ? Si vous avez déjà rencontré java.lang.UnsupportedClassVersionError, vous savez que cela ressemble à une conversation entre deux personnes parlant des langues différentes. Votre programme Java parle la version 61.0 (Java 17), mais l'environnement d'exécution ne comprend que jusqu'à la version 55.0 (Java 11).

Dans ce tutoriel, nous allons voir ce qu'est Unsupported major.minor version, pourquoi elle apparaît et, surtout, comment la corriger. Nous ne donnerons pas seulement des solutions toutes faites, mais nous vous apprendrons à comprendre la racine du problème. C'est parti !

Qu'est-ce que la version major.minor ? Petit cours accéléré

Chaque fichier .class en Java possède une étiquette interne — la version major.minor. C'est le numéro de version du format bytecode créé par le compilateur javac. Par exemple :

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

Lorsque vous lancez une application, la JRE (Java Runtime Environment) vérifie si elle peut "comprendre" ce fichier. Si la version du fichier est plus récente que celle de la JRE, vous obtenez java.lang.UnsupportedClassVersionError.

Une analogie simple : imaginez que vous essayez d'ouvrir un document PDF créé dans Adobe Acrobat 2023 avec Adobe Reader 2010. Le programme dira : "Je ne connais pas ce format".

Causes principales de l'erreur UnsupportedClassVersionError

L'erreur Unsupported major.minor version peut survenir pour plusieurs raisons :

\n
• Versions différentes de JDK et JRE : Vous avez compilé le code avec JDK 17, mais vous l'exécutez sur JRE 11.
\n
• Bibliothèques tierces : Vous avez ajouté un fichier JAR compilé pour Java 17, mais votre environnement d'exécution est Java 8.
\n
• Configuration incorrecte de Maven/Gradle : Le fichier de build spécifie une version de Java, mais une autre est installée sur le serveur.
\n
• Déploiement sur un ancien serveur : Vous développez sur un IDE moderne, mais le serveur de production utilise une version obsolète de Java.
\n

Tutoriel pas à pas : comment corriger l'erreur

Examinons les étapes concrètes pour résoudre le problème. Nous aborderons trois scénarios principaux.

Étape 1 : Vérifiez les versions de Java

La première chose à faire est de comprendre "qui est en cause". Ouvrez un terminal et exécutez :

# Version avec laquelle vous compilez (JDK)\njavac -version\n\n# Version avec laquelle vous exécutez (JRE)\njava -version

Si elles ne correspondent pas — voilà la cause. Par exemple, javac affiche "17.0.1" et java affiche "11.0.12".

Solution : Installez les mêmes versions, soit en mettant à jour la JRE, soit en abaissant la version de compilation (voir ci-dessous).

Étape 2 : Corrigez les paramètres de compilation

Si vous ne pouvez pas mettre à jour la JRE (par exemple sur un serveur), vous devez compiler le code pour une version plus ancienne. Utilisez les options -source et -target dans le compilateur :

// Compile le code Java 17, mais génère du bytecode pour Java 11\njavac -source 17 -target 11 MyApp.java

Important : -source indique la syntaxe Java que vous utilisez, et -target spécifie pour quelle version de JRE générer le fichier .class. Si votre code utilise des fonctionnalités de Java 17 (par exemple, les expressions switch), elles seront compilées en bytecode compatible.