Migrer de Java 8 vers Java 21 et Spring Boot 3 : un plan qui ne bloque pas vos livraisons

Qasim Ali · Ingénieur logiciel senior (Java, IA), CS2 Technologies
Publié le · Lecture : 7 min

Si votre équipe roule encore sur Java 8 ou 11 avec Spring Boot 2, cette migration traîne sans doute dans le carnet de travail depuis un moment. Elle perd chaque fois contre la prochaine fonction demandée par un client, parce que le système fonctionne et qu’une migration ne se montre pas en démo.

Le problème, c’est que le coût de l’attente augmente sans bruit. Chaque mois, un peu plus de bibliothèques ne publient leurs correctifs que pour la nouvelle pile, et le saut que vous devrez faire un jour s’allonge d’autant.

Cet article s’adresse au gestionnaire en ingénierie ou au CTO qui doit planifier ce saut. Il explique pourquoi le moment est bien choisi, ce qui brise réellement, comment découper le travail en étapes qui vont chacune en production, et comment estimer l’effort à partir de votre propre code plutôt que d’une règle approximative.

1. Pourquoi la migration n’est plus facultative

Spring Boot 3 exige au minimum Java 17 et repose sur Jakarta EE. Le soutien open source de Spring Boot 2 a pris fin : les correctifs de sécurité du cadriciel sous votre application n’arrivent plus que sur la branche 3.x, à moins de payer un soutien commercial prolongé. Oracle a cessé depuis des années les mises à jour publiques gratuites de Java 8 pour un usage commercial. D’autres distributions publient encore des versions corrigées de 8 et 11, mais l’écosystème avance : les nouvelles versions de pilotes, de SDK et de bibliothèques ciblent de plus en plus Java 17 et Spring Boot 3 seulement.

Il y a aussi l’aspect humain. Les développeurs Spring expérimentés s’attendent à travailler avec une version actuelle, et un candidat qui voit Java 8 dans l’offre d’emploi va se demander ce qui d’autre est désuet. Et de vrais gains vous attendent de l’autre côté. Java 21 est une version à soutien à long terme, avec les fils virtuels (virtual threads), les records et le filtrage par motif. À partir de Spring Boot 3.2, un simple paramètre permet de traiter les requêtes sur des fils virtuels. Pour des services qui passent le plus clair de leur temps à attendre une base de données ou une autre API, ça peut vouloir dire plus de requêtes simultanées sur le même matériel. Mesurez-le sur votre propre charge avant d’en faire un argument.

Pour les gestionnaires: Rester sur Spring Boot 2, c’est rouler sans correctifs de sécurité en amont. Voyez la migration comme de l’entretien obligatoire, et les nouvelles fonctions comme un bonus.

2. Le passage de javax à jakarta touche plus de choses qu’on pense

Jakarta EE a renommé les paquets : javax.persistence est devenu jakarta.persistence, javax.servlet est devenu jakarta.servlet, javax.validation est devenu jakarta.validation, et ainsi de suite. Spring Boot 3 utilise partout les nouveaux noms. Dans votre propre code, le changement tient surtout du rechercher-remplacer, et des outils comme OpenRewrite en automatisent une bonne partie.

Le plus difficile, c’est tout ce que vous n’avez pas écrit. Chaque bibliothèque qui touche aux servlets, à la persistance ou à la validation doit passer à une version conçue pour jakarta, et certaines n’en ont jamais eu. Springfox, souvent utilisé pour générer la documentation Swagger, ne fonctionne pas avec Spring Boot 3; on passe en général à springdoc-openapi 2. Spring Cloud Sleuth a été remplacé par Micrometer Tracing. Les configurations RestTemplate basées sur Apache HttpClient 4 doivent passer à HttpClient 5. Si vous déployez des fichiers WAR sur un Tomcat externe, ce serveur doit lui aussi passer à une version compatible jakarta. Attention : certains paquets javax, comme javax.sql et javax.crypto, font partie du JDK et ne changent pas. Un remplacement aveugle dans tout le code crée donc ses propres bris.

Pour les gestionnaires: Avant d’estimer, dressez la liste de chaque dépendance externe et vérifiez si elle offre une version compatible jakarta. Ce sont les bibliothèques sans version qui fixent votre échéancier.

3. La sécurité, Hibernate et le JDK lui-même

Spring Security 6 a retiré WebSecurityConfigurerAdapter. La configuration de sécurité passe maintenant par un bean SecurityFilterChain, antMatchers cède la place à requestMatchers, et authorizeRequests à authorizeHttpRequests. La réécriture est habituellement courte. Une erreur peut toutefois ouvrir ou fermer un point d’accès sans que personne s’en aperçoive, alors chaque règle d’accès a besoin d’un test qui prouve qui peut l’atteindre et qui ne le peut pas. Spring Framework 6 a aussi cessé de faire correspondre la barre oblique finale par défaut : un client qui appelle /orders/ n’atteint plus un contrôleur associé à /orders.

Hibernate 6 arrive avec Spring Boot 3. Son analyseur de requêtes est plus strict, donc du HQL que les anciennes versions toléraient peut échouer au démarrage ou se comporter autrement. Les types de colonnes personnalisés, la génération d’identifiants et certaines requêtes natives sont à vérifier. Côté JDK, Java 11 a retiré les modules Java EE qui étaient livrés avec lui (dont JAXB et JAX-WS), et Java 17 encapsule fortement les classes internes du JDK, si bien que les bibliothèques qui y accédaient par réflexion se mettent à échouer. L’outillage de compilation doit suivre lui aussi : les anciennes versions de Lombok, Mockito, JaCoCo et de divers plugiciels Maven ou Gradle ne lisent pas les nouveaux fichiers de classes.

Pour les gestionnaires: Les changements risqués se trouvent dans la configuration de sécurité et dans les requêtes à la base de données. Assurez-vous que les deux sont couverts par des tests avant d’y toucher.

4. Installer le filet de sécurité d’abord

Une migration sans tests, c’est un pari dont on découvre le résultat en production. Pas besoin d’une couverture complète pour commencer. Il faut couvrir les parcours qui feraient mal : la connexion et les permissions, les principales écritures, la facturation ou les paiements s’il y en a, et les intégrations dont d’autres systèmes dépendent.

Là où les tests unitaires sont minces, écrivez quelques tests larges qui appellent la vraie API et vérifient la réponse. Ils sont rudimentaires, mais ils attrapent un champ JSON modifié, un en-tête manquant ou une requête qui renvoie d’autres lignes. Un pipeline vert qui roule ces tests à chaque commit est le meilleur indice d’une migration sans drame.

Pour les gestionnaires: Consacrez la première partie du budget aux tests des parcours les plus importants. Tout le reste coûte moins cher ensuite.

5. Migrer par étapes, chacune livrée en production

Le découpage qui fonctionne habituellement ressemble à ceci. D’abord, amenez Spring Boot 2 à sa dernière branche, 2.7, et Java à la version 17, sur laquelle 2.7 fonctionne. Vous séparez ainsi les problèmes du JDK de ceux du cadriciel. Ensuite, toujours sur 2.7, éliminez les avertissements de dépréciation et passez la configuration de sécurité au style SecurityFilterChain, que 2.7 prend déjà en charge. Puis faites le vrai saut vers Spring Boot 3, l’espace de noms jakarta et Hibernate 6, avec le module spring-boot-properties-migrator pour repérer les paramètres renommés. Enfin, passez l’exécution à Java 21 et décidez, mesures à l’appui, si les fils virtuels aident votre charge.

Chaque étape se rend jusqu’en production et y tourne un certain temps avant la suivante. Si quelque chose brise, vous savez quelle étape en est la cause, et revenir en arrière est un petit pas plutôt qu’un trimestre perdu. Si vous avez plusieurs services, migrez d’abord de bout en bout un service à faible risque, puis appliquez ce que vous avez appris aux autres.

Pour les gestionnaires: Ne combinez jamais la migration de Java, celle de Spring Boot et de nouvelles fonctions dans une même livraison. Les petits pas rendent chaque panne facile à retracer.

6. Estimer l’effort à partir de votre propre code

Nous ne vous donnerons pas un nombre de semaines par millier de lignes, parce que la taille du code n’est qu’un facteur parmi d’autres, et rarement le plus lourd. Ce qui fait bouger l’estimation, c’est le nombre de modules ou de services, le nombre de dépendances sans version jakarta, la quantité de code de sécurité et d’Hibernate personnalisé, et la qualité de la couverture de tests.

La façon la plus fiable de le savoir, c’est un court essai technique, limité dans le temps. Roulez les recettes de migration automatisées sur une branche, compilez, lancez les tests et comptez ce qui reste : erreurs de compilation, tests en échec, bibliothèques sans chemin de mise à niveau. Cette liste remplace une inquiétude vague par un carnet de travail qu’on peut chiffrer. Si personne dans l’équipe n’a le temps de faire cet essai, une évaluation technique à portée fixe fait le même travail de l’extérieur. Nous lisons le code Java, le pipeline et la posture de sécurité, puis nous mettons les constats par écrit : quoi garder, quoi moderniser en premier et ce que ça demandera.

Pour les gestionnaires: Fondez l’estimation sur un essai réalisé sur votre vrai code. Un plan bâti sur la liste réelle des bris vaut mieux que n’importe quelle règle approximative.

7. Continuer à livrer des fonctions pendant la migration

La pire façon de migrer, c’est sur une branche de longue durée qui s’éloigne chaque semaine de la branche principale pendant que l’équipe produit continue de livrer. Fusionnez plutôt le travail de migration dans la branche principale par petits morceaux. La plupart des premières étapes, des nouveaux tests jusqu’à Java 17 et la configuration de sécurité remise à neuf, restent compatibles avec l’ancienne pile et peuvent être livrées en même temps que les fonctions habituelles.

Le saut vers jakarta est le seul changement qui doit vraiment arriver d’un bloc dans chaque service. Gardez cette fenêtre courte en faisant tout le reste avant, et entendez-vous avec l’équipe produit sur quelques jours où les changements à ce service sont suspendus. Certaines équipes confient la migration à un petit groupe ou à une équipe externe, pour que les autres gardent leur rythme. C’est ainsi que CS2 aborde la modernisation : sur la plateforme de Vodafone Kabel Deutschland, la migration de Java EE 7 vers Spring Boot et le passage d’OAuth 1.0 à JWT se sont faits sur le système en service, pendant que les techniciens sur le terrain continuaient de l’utiliser chaque jour. Nos propres produits, Notermed et GWS Connect, tournent sur des API Java 17 Spring Boot; nous suivons donc le même chemin de mise à niveau dans notre propre code.

Pour les gestionnaires: Fusionnez petit et souvent, et réservez la seule vraie bascule à une fenêtre courte et annoncée pour chaque service.

En bref

Spring Boot 2 n’a plus de soutien open source, et Spring Boot 3 exige Java 17 et l’espace de noms jakarta. Les parties difficiles sont les bibliothèques externes, la configuration de sécurité et les requêtes Hibernate : couvrez-les de tests en premier. Migrez par étapes qui vont chacune en production, estimez à partir d’un essai sur votre vrai code et continuez à livrer en fusionnant de petits changements dans la branche principale.

Qasim Ali

Ingénieur logiciel senior (Java, IA), CS2 Technologies

Qasim cumule 18 ans d’expérience en systèmes dorsaux, dont dix ans sur la plateforme dorsale de Vodafone Kabel Deutschland, et travaille avec l’équipe de CS2 sur des systèmes Java et Spring Boot, pour des clients comme pour les produits de CS2. Si une migration dort dans votre carnet de travail, il discutera volontiers avec vous de la meilleure façon de commencer.