Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

StackOverflowError — transbordamento da pilha de chamadas

A JVM pode lançar StackOverflowError quando um cálculo necessita de mais espaço do que o permitido na pilha da thread. Uma recursão profunda é uma causa comum, mas uma cadeia de chamadas não recursiva suficientemente profunda também pode fazer transbordar a pilha. O erro pertence à hierarquia de Error, não à de Exception; normalmente, é necessário corrigir a estrutura das chamadas aos métodos em vez de capturar o erro.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

StackOverflowError, do pacote java.lang, assinala que um cálculo excedeu o tamanho permitido da pilha da thread. Uma recursão profunda é uma causa comum, mas uma cadeia de chamadas não recursiva suficientemente profunda também pode fazer transbordar a pilha. Estende VirtualMachineError e, indiretamente, Error. Não é um subtipo de Exception, pelo que catch (Exception e) não o captura. Enquanto erro não verificado, não requer uma declaração throws.

O construtor StackOverflowError() cria um objeto sem mensagem detalhada; StackOverflowError(String s) guarda a mensagem fornecida. A simples criação do objeto não faz a pilha transbordar nem lança o erro. O exemplo cria um objeto StackOverflowError, lê a respetiva mensagem com getMessage() e apresenta-a (demo). Em seguida, avalia error instanceof Error e apresenta o resultado, true, na segunda linha.

Perante um transbordamento real, verifica a profundidade da cadeia de chamadas e procura ciclos de chamadas entre métodos. Se houver recursão, verifica a sua condição de terminação e considera limitar-lhe a profundidade ou substituí-la por iteração. Não faças depender a correção de um número fixo de chamadas permitidas: a profundidade disponível depende da plataforma e da pilha da thread. Capturar Error não deve ser um mecanismo normal de controlo do fluxo do programa.

A documentação abrange Java SE 21; o ambiente de execução de produção não foi atestado. O exemplo foi executado num ambiente isolado e a sua saída padrão coincidiu exatamente com a saída apresentada.

Exemplos

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);
    }
}

Resultado

demo
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes