CKTIS / Java
OutOfMemoryError — falha na alocação de memória
OutOfMemoryError indica um problema de alocação de memória da JVM. É um subtipo de Error, não de Exception, e não requer uma declaração throws. Não significa automaticamente que existe uma fuga de memória ou que a heap Java está simplesmente cheia.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new OutOfMemoryError()
new OutOfMemoryError("detail message")java.lang.OutOfMemoryError herda de VirtualMachineError e, através deste, de Error e Throwable. A JVM lança-o quando não consegue criar um objeto por falta de memória e o coletor de lixo não consegue disponibilizar mais.
Enquanto subtipo de Error, é não verificado: não é necessária uma declaração throws. Um bloco catch (Exception e) não o captura. Embora seja possível capturá-lo explicitamente, não o trate como um caso normal de dados inválidos nem parta do princípio de que a aplicação pode continuar em segurança.
O construtor OutOfMemoryError() cria um objeto sem mensagem detalhada; OutOfMemoryError(String s) guarda a mensagem fornecida. A JVM pode criar estes objetos com a supressão desativada ou com um rasto da pilha não modificável. Por isso, não parta do princípio de que estão sempre disponíveis informações de diagnóstico completas.
Para diagnosticar, distinga as mensagens: Java heap space diz respeito à heap, Metaspace aos metadados das classes e Requested array size exceeds VM limit a um limite do tamanho dos arrays independente da heap disponível. Também podem ocorrer falhas de alocação de memória nativa. O erro, por si só, não prova a existência de uma fuga; identifique o recurso e a causa antes de aumentar automaticamente -Xmx.
O exemplo apenas cria um objeto de diagnóstico: não o lança nem esgota a memória. Apresenta o nome da classe, a mensagem e a relação de herança. Âmbito da documentação: Java SE 21; o ambiente de execução do repositório não confirma a versão do ambiente de produção.
Exemplos
public class Main {
public static void main(String[] args) {
OutOfMemoryError error = new OutOfMemoryError("demo only");
System.out.println(error.getClass().getSimpleName());
System.out.println(error.getMessage());
System.out.println(error instanceof VirtualMachineError);
}
}Resultado
OutOfMemoryError demo only 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.