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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de cannot find symbol (la compilare), ClassNotFoundException apare la rulare, când o clasă e încărcată după nume, ca text: Class.forName("com.mysql.cj.jdbc.Driver"), configurări Spring, Hibernate, fișiere XML sau META-INF. Compilatorul nu poate verifica un text, deci afli abia la rulare.
Mesajul conține numele complet al clasei căutate. În stivă vezi BuiltinClassLoader.loadClass și Class.forName, apoi linia ta.
Cauze frecvente: biblioteca nu e în dependențe sau are scope greșit (de exemplu provided / test); numele clasei e scris greșit sau e din altă versiune (com.mysql.jdbc.Driver vechi vs com.mysql.cj.jdbc.Driver nou); aplicația e rulată fără -cp cu fișierele .jar. O variantă înrudită este Error: Could not find or load main class Main, când chiar clasa de pornire nu e găsită (comanda e rulată din alt folder sau cu numele greșit).
De ce apare: cauzele frecvente
1Driverul JDBC lipsește din dependențe
<!-- pom.xml fără driverul MySQL -->
Class.forName("com.mysql.cj.jdbc.Driver");<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.4.0</version>
</dependency>Clasa există doar în biblioteca driverului. Fără dependență, nu e în classpath la rulare.
2Nume de clasă scris greșit
Class.forName("org.postgresql.driver");Class.forName("org.postgresql.Driver");Numele claselor sunt case-sensitive și trebuie scrise complet, cu pachetul.
3Rulare din terminal fără classpath
java Mainjava -cp .:lib/mysql-connector-j-8.4.0.jar MainLa rulare, Java trebuie să știe unde sunt fișierele .jar. Pe Windows, separatorul e ;.
Repară eroarea, direct în pagină
Programul alege la rulare clasa care calculează taxa de livrare, după numele ei, dar se oprește cu java.lang.ClassNotFoundException: Main$livrareRapida. Repară numele clasei din text, ca programul să afișeze Clasa gasita: LivrareRapida.
public class Main {
static class LivrareRapida { }
public static void main(String[] args) throws Exception {
Class<?> c = Class.forName("Main$livrareRapida");
System.out.println("Clasa gasita: " + c.getSimpleName());
}
}Clasa gasita: LivrareRapida
Indiciu
Numele claselor sunt case-sensitive; compară textul cu declarația clasei.
Reparația
public class Main {
static class LivrareRapida { }
public static void main(String[] args) throws Exception {
Class<?> c = Class.forName("Main$LivrareRapida");
System.out.println("Clasa gasita: " + c.getSimpleName());
}
}De ce merge
Class.forName primește numele clasei ca text, deci compilatorul nu poate verifica dacă există, iar greșeala apare abia la rulare. Clasa e declarată LivrareRapida, cu literă mare, iar fiind în interiorul lui Main, numele ei complet este Main$LivrareRapida. Cu numele scris exact, clasa e găsită. La un driver JDBC, aceeași excepție apare și când biblioteca lipsește din dependențe.
Alte forme ale mesajului
java.lang.ClassNotFoundException: org.postgresql.Driverjava.lang.ClassNotFoundException: com.mysql.jdbc.DriverError: Could not find or load main class Main Caused by: java.lang.ClassNotFoundException: Mainjava.lang.NoClassDefFoundError: org/slf4j/LoggerFactoryjava.sql.SQLException: No suitable driver found for jdbc:mysql://localhost:3306/magazin
Cum o eviți pe viitor
- Adaugă bibliotecile prin Maven sau Gradle și verifică
scope-ul lor. - Copiază numele claselor de driver din documentația oficială a versiunii pe care o folosești.
- Cu JDBC 4+, nu mai e nevoie de
Class.forName: driverul se încarcă singur dacă e în classpath. - Rulează aplicația cu
mvn exec:java, din IDE sau ca jar complet (fat jar), nu cujava Mainsimplu.
Întrebări frecvente
Care e diferența dintre ClassNotFoundException și NoClassDefFoundError?
ClassNotFoundException apare când cauți o clasă după nume (Class.forName) și nu există. NoClassDefFoundError apare când o clasă a existat la compilare, dar lipsește la rulare, sau inițializarea ei a eșuat anterior.
Ce fac la Could not find or load main class Main?
Rulează java din folderul care conține Main.class (sau rădăcina pachetelor), cu numele complet al clasei (java com.firma.Main) și fără extensia .class. Dacă ai compilat cu alt nume, verifică exact cum se numește clasa.
Erori înrudite
error: package org.junit does not exist Compilatorul nu găsește pachetul din import: fie numele e scris greșit (java.utils în loc de java.util), fie biblioteca nu e adăugată în proiect (în pom.xml / build.gradle sau în classpath). Corectează numele sau adaugă dependența. java.lang.ExceptionInInitializerError A apărut o excepție în timp ce Java inițializa partea static a unei clase (un câmp static sau un bloc static {}). Cauza reală e în linia Caused by de sub mesaj. Repară acea excepție sau mută codul riscant din inițializarea statică într-o metodă. error: cannot find symbol Compilatorul nu găsește un nume folosit în cod: o variabilă, o metodă sau o clasă. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau un import lipsă; liniile symbol și location din mesaj îți spun exact ce lipsește. Î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.
