...
Eroare Java · Stiva de apeluri, tablouri și încărcarea claselor

java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver

Pe scurt

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

Greșit
JAVA
<!-- pom.xml fără driverul MySQL -->
Class.forName("com.mysql.cj.jdbc.Driver");
Corect
JAVA
<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

Greșit
JAVA
Class.forName("org.postgresql.driver");
Corect
JAVA
Class.forName("org.postgresql.Driver");

Numele claselor sunt case-sensitive și trebuie scrise complet, cu pachetul.

3Rulare din terminal fără classpath

Greșit
JAVA
java Main
Corect
JAVA
java -cp .:lib/mysql-connector-j-8.4.0.jar Main

La rulare, Java trebuie să știe unde sunt fișierele .jar. Pe Windows, separatorul e ;.

Repară tu

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.

Codul care dă eroarea
JAVA
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());
    }
}
După reparație, programul afișează
Clasa gasita: LivrareRapida
Indiciu

Numele claselor sunt case-sensitive; compară textul cu declarația clasei.

Alte forme ale mesajului

  • java.lang.ClassNotFoundException: org.postgresql.Driver
  • java.lang.ClassNotFoundException: com.mysql.jdbc.Driver
  • Error: Could not find or load main class Main Caused by: java.lang.ClassNotFoundException: Main
  • java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory
  • java.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 cu java Main simplu.

Î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

← 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.