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.