...
Eroare Java · Reflecție, module și alte API-uri

java.lang.InstantiationException

Pe scurt

Prin reflecție încerci să creezi un obiect dintr-o clasă care nu poate avea instanțe: o clasă abstractă, o interfață, un enum sau un tip primitiv. Creează obiectul dintr-o clasă concretă (de exemplu Cerc, nu Forma).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Constructor.newInstance() (și vechiul Class.newInstance()) construiește un obiect dintr-o clasă aleasă la rulare, de exemplu dintr-un nume citit din configurare. Dacă acea clasă e abstract sau e o interfață, Java nu o poate instanția și aruncă InstantiationException. Excepția apare fără mesaj, așa că numele clasei îl afli din codul tău sau din configurare.

Cazurile reale: în configurare e trecut numele clasei de bază (Forma) în loc de implementare (Cerc), un framework încearcă să creeze o interfață pentru că lipsește implementarea, sau Class.forName primește numele unei interfețe.

Caută în stiva de apeluri rândul cu newInstance din codul tău și verifică ce clasă era încărcată acolo: clasa.getName() și Modifier.isAbstract(clasa.getModifiers()) te ajută să afli imediat.

De ce apare: cauzele frecvente

1Clasa de bază în loc de implementare

Greșit
JAVA
Class<?> c = Class.forName("Main$Forma"); // abstract class Forma
Object f = c.getDeclaredConstructor().newInstance();
Corect
JAVA
Class<?> c = Class.forName("Main$Cerc"); // class Cerc extends Forma
Object f = c.getDeclaredConstructor().newInstance();

Doar o clasă concretă poate avea obiecte. Cerc implementează tot ce lipsea din Forma.

2Verificare înainte de instanțiere

Greșit
JAVA
Object o = clasa.getDeclaredConstructor().newInstance();
Corect
JAVA
if (clasa.isInterface() || Modifier.isAbstract(clasa.getModifiers())) {
    throw new IllegalArgumentException(clasa.getName() + " nu poate fi instantiata");
}
Object o = clasa.getDeclaredConstructor().newInstance();

Un mesaj propriu spune clar ce clasă e greșită, în loc de o excepție fără mesaj.

Repară tu

Repară eroarea, direct în pagină

Programul creează forma aleasă în configurare prin reflecție, dar în configurare e trecută clasa abstractă Forma și programul se oprește cu java.lang.InstantiationException. Pune în configurare clasa concretă Main$Cerc, ca programul să afișeze Aria: 12.

Codul care dă eroarea
JAVA
public class Main {
    public static abstract class Forma {
        public abstract int aria();
    }

    public static class Cerc extends Forma {
        public int aria() { return 3 * 2 * 2; }
    }

    public static void main(String[] args) throws Exception {
        String clasaDinConfig = "Main$Forma";
        Class<?> c = Class.forName(clasaDinConfig);
        Forma f = (Forma) c.getDeclaredConstructor().newInstance();
        System.out.println("Aria: " + f.aria());
    }
}
După reparație, programul afișează
Aria: 12
Indiciu

Doar o clasă concretă, care nu e abstract, poate fi instanțiată.

Cum o eviți pe viitor

  • În configurare, scrie numele clasei concrete și verifică-l la pornirea aplicației.
  • Înainte de newInstance, verifică isInterface() și Modifier.isAbstract(...).
  • Când poți, înlocuiește reflecția cu un Map<String, Supplier<Forma>>: Map.of("cerc", Cerc::new) e verificat de compilator.
  • Folosește getDeclaredConstructor().newInstance(), nu metoda depreciată Class.newInstance().

Întrebări frecvente

Care e diferența față de eroarea de compilare is abstract; cannot be instantiated?

Este aceeași regulă. Cu new Forma(), compilatorul vede clasa și te oprește înainte de rulare. Prin reflecție, clasa e aleasă la rulare, deci problema apare ca excepție.

De ce excepția nu are mesaj?

Constructor.newInstance o aruncă fără text. Afișează tu numele clasei când o prinzi, ca să știi ce valoare din configurare e greșită.

Erori înrudite

← Toate erorile Java

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.