Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

StackOverflowError — débordement de la pile d’appels

La JVM peut lancer StackOverflowError lorsqu’un calcul nécessite plus d’espace que ne le permet la pile du thread. Une récursion profonde en est une cause fréquente, mais une chaîne d’appels non récursive suffisamment profonde peut aussi faire déborder la pile. Cette erreur relève de la hiérarchie d’Error, non de celle d’Exception ; il faut généralement corriger la structure des appels de méthodes plutôt que capturer l’erreur.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

public class StackOverflowError extends VirtualMachineError
public StackOverflowError()
public StackOverflowError(String s)

StackOverflowError, dans java.lang, signale qu’un calcul a dépassé la taille autorisée de la pile du thread. Une récursion profonde en est une cause fréquente, mais une chaîne d’appels non récursive suffisamment profonde peut aussi faire déborder la pile. Il étend VirtualMachineError et, indirectement, Error. Ce n’est pas un sous-type de Exception : catch (Exception e) ne le capture donc pas. En tant qu’erreur non contrôlée, il ne nécessite pas de déclaration throws.

Le constructeur StackOverflowError() crée un objet sans message détaillé ; StackOverflowError(String s) enregistre le message fourni. La simple création de l’objet ne fait ni déborder la pile ni ne déclenche l’erreur. L’exemple crée un objet StackOverflowError, récupère son message avec getMessage() et l’affiche (demo). Il évalue ensuite error instanceof Error et affiche le résultat, true, sur la deuxième ligne.

En cas de débordement réel, vérifiez la profondeur de la chaîne d’appels et recherchez les cycles d’appels entre méthodes. S’il y a récursion, examinez sa condition d’arrêt et envisagez d’en limiter la profondeur ou de la remplacer par une itération. Ne faites pas dépendre la correction du programme d’un nombre fixe d’appels autorisés : la profondeur disponible dépend de la plateforme et de la pile du thread. Capturer Error ne devrait pas être un mécanisme normal de contrôle du programme.

La documentation porte sur Java SE 21 ; l’environnement d’exécution de production n’a pas été attesté. L’exemple a été exécuté dans un environnement isolé, et sa sortie standard correspondait exactement à la sortie présentée.

Exemples

public class Main {
    public static void main(String[] args) {
        StackOverflowError error = new StackOverflowError("demo");
        System.out.println(error.getMessage());
        System.out.println(error instanceof Error);
    }
}

Résultat

demo
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources