Accueil › Spring Boot › Images natives avec GraalVM
Images natives avec GraalVM
En productionavance
Une image native est un exécutable autonome, produit par compilation ahead-of-time (AOT) avec GraalVM : le code Java est traduit en code machine au moment du build, et non plus interprété/compilé à la volée par une JVM classique. Le gain principal est le démarrage (millisecondes au lieu de secondes) et la mémoire résidente réduite.
Spring Boot 3 ajoute une étape de traitement AOT avant la compilation native : elle analyse le contexte Spring (beans, configuration, proxies) au moment du build plutôt qu'au démarrage, et génère le code et les hints nécessaires pour que GraalVM sache quoi conserver.
# compilation native locale (nécessite GraalVM installé)
mvn -Pnative native:compile
# alternative : image de conteneur, sans installer GraalVM
mvn spring-boot:build-image -Pnative
Le coût principal est le temps de build (souvent plusieurs minutes contre quelques secondes pour un jar classique) et l'hypothèse de monde fermé : GraalVM doit connaître, dès la compilation, tout ce qui sera utilisé par réflexion, proxy dynamique ou chargement de ressource. Un code qui fonctionne normalement sur une JVM peut échouer silencieusement en natif s'il utilise de la réflexion non déclarée — d'où l'importance de tester réellement le binaire natif, pas seulement le jar classique.
Les termes à connaître
- Compilation AOT (ahead-of-time)
Compilation du bytecode Java directement en code machine exécutable, réalisée au moment du build plutôt qu'à l'exécution. C'est le rôle du compilateur natif de GraalVM : le résultat est un binaire autonome, sans JVM embarquée classique ni interprétation de bytecode au démarrage.
- Traitement AOT de Spring
Étape ajoutée par Spring Framework 6 / Spring Boot 3 avant la compilation native : elle analyse le contexte de l'application (beans, proxies, configuration) à la place de le faire à l'exécution, et génère du code Java équivalent ainsi que des
RuntimeHints. Elle remplace une grande partie de la réflexion normalement utilisée par le conteneur Spring.- RuntimeHints
Mécanisme (
org.springframework.aot.hint.RuntimeHints) qui déclare, pour le compilateur natif, ce qui doit rester accessible par réflexion, proxy dynamique ou ressource dans le binaire final — puisque l'hypothèse de monde fermé empêche GraalVM de le déduire seul. On les enregistre via unRuntimeHintsRegistrar, souvent combiné à@ImportRuntimeHints.- Hypothèse de monde fermé (closed-world assumption)
Principe de la compilation native : tout le code accessible à l'exécution doit être identifiable au moment du build. Aucune classe chargée dynamiquement après coup, aucun chemin de code atteint uniquement par réflexion non déclarée — sous peine d'échec silencieux ou d'exception au runtime.
- native-maven-plugin (org.graalvm.buildtools)
Plugin Maven fourni par GraalVM Buildtools, ajouté par le profil
natived'un projet Spring Initializr. Sa commande principale,mvn -Pnative native:compile, déclenche le traitement AOT de Spring puis la compilation native, en produisant un binaire exécutable.- spring-boot:build-image -Pnative
Alternative qui construit une image de conteneur contenant un exécutable natif, sans installer GraalVM localement : le compilateur natif tourne dans un buildpack (Cloud Native Buildpacks), à l'intérieur du build Docker/Podman.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.