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

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.

Fontes