Resolução de ProblemasOutOfMemory: checklist

    OutOfMemory: checklist

    Esta página resolve java.lang.OutOfMemoryError (heap/metaspace), servidor fechando sozinho e crashes ao gerar mundo ou carregar muitos plugins.

    "Sem memória" pode ser RAM insuficiente ou vazamento (leak) causado por plugin/mod/config.

    Tipos comuns de OutOfMemory

    1) Java heap space

    Faltou memória para o servidor rodar mundo/entidades/plugins.

    2) Metaspace

    Faltou memória para carregar classes (muito plugin/mod ou comportamento anormal).

    Checklist (ordem recomendada)

    1) Confirme quanta RAM o servidor realmente tem

    • RAM total do host/plano.
    • Limite real do container (se houver).
    • Quanto está alocado para o Java.

    Alocar mais do que o limite do plano pode piorar (o processo é morto ou fica instável).

    2) Ajuste a alocação do Java (sem exagero)

    • Aumente o máximo (Xmx) com margem.
    • Deixe RAM livre para o sistema e overhead.

    Recomendação prática: não aloque 100% da RAM total para o Java.

    3) Se começou após instalar algo: reverta

    • Remova o último plugin/mod/datapack instalado.
    • Teste de novo.
    • Volte um por um até achar o culpado.

    4) Identifique padrão de tempo

    • Cai ao iniciar: falta RAM ou plugin muito pesado.
    • Cai após 1–6 horas: suspeita forte de leak.

    5) Reduza carga do mundo

    • Reduza view/simulation distance.
    • Limite entidades (villagers, mobs, itens no chão).
    • Evite geração de mundo em massa em horário de pico.

    6) Se for modpack

    • Modpack pesado precisa de RAM proporcional.
    • Reduza mods ou suba o plano/limite de RAM.

    Como prevenir

    • Não instalar "muita coisa" de uma vez.
    • Monitorar uso de RAM (tendência de crescimento contínuo = alerta de leak).
    • Reinícios programados ajudam, mas não substituem corrigir a causa.

    O que enviar no suporte

    1. Stacktrace completo do OutOfMemoryError.
    2. RAM do plano/host e quanto você alocou para o Java.
    3. Versões: Minecraft + tipo do servidor + build e Java.
    4. Lista de plugins/mods/datapacks.
    5. Padrão: cai ao iniciar, após X horas, ou quando muitos players entram.
    6. Últimas 300 linhas do log antes do crash.

    Links úteis