java.lang.InstantiationException
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
Class<?> c = Class.forName("Main$Forma"); // abstract class Forma
Object f = c.getDeclaredConstructor().newInstance();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
Object o = clasa.getDeclaredConstructor().newInstance();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ă 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.
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());
}
}Aria: 12
Indiciu
Doar o clasă concretă, care nu e abstract, poate fi instanțiată.
Reparația
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$Cerc";
Class<?> c = Class.forName(clasaDinConfig);
Forma f = (Forma) c.getDeclaredConstructor().newInstance();
System.out.println("Aria: " + f.aria());
}
}De ce merge
Forma e abstractă: are metoda aria() fără corp, deci un obiect Forma n-ar ști ce să facă. Constructorul ei există (pentru subclase), dar newInstance refuză să-l folosească direct și aruncă InstantiationException. Main$Cerc e numele binar al clasei interne Cerc, care e concretă, deci obiectul se creează, iar aria() întoarce 12.
Cum o eviți pe viitor
- În configurare, scrie numele clasei concrete și verifică-l la pornirea aplicației.
- Înainte de
newInstance, verificăisInterface()șiModifier.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
error: Forma is abstract; cannot be instantiated Ai încercat să creezi cu new un obiect dintr-o clasă abstractă sau dintr-o interfață. Acestea sunt doar modele: creează un obiect dintr-o subclasă concretă (new Dreptunghi(...)) și păstrează-l, dacă vrei, într-o variabilă de tipul abstract. java.lang.NoSuchMethodException: Main$Produs.<init>() Codul care creează obiecte prin reflecție (getDeclaredConstructor().newInstance(), Jackson, JPA/Hibernate, framework-uri) caută un constructor fără parametri, iar clasa ta nu are. Adaugă un constructor gol: public Produs() { }. java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver Java a căutat la rulare o clasă după nume (Class.forName, un driver JDBC, un framework) și n-a găsit-o în classpath. De obicei lipsește biblioteca (driverul MySQL / PostgreSQL) din dependențe sau numele clasei e scris greșit. Adaugă dependența sau corectează numele complet. java.lang.reflect.InvocationTargetException Metoda apelată prin reflecție (Method.invoke) sau constructorul (newInstance) a aruncat ea însăși o excepție, iar reflecția ți-o dă împachetată. Cauza reală e la Caused by: în stivă sau în e.getCause(); acolo repari. Î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.
