java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver
Programul a încercat să încarce o clasă după nume (Class.forName, un driver JDBC, un plugin, deserializare), dar clasa nu există pe classpath. De obicei lipsește dependența din Gradle/Maven sau numele e scris greșit. Adaugă biblioteca sau corectează numele complet al clasei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ClassNotFoundException apare când codul cere o clasă după nume, la rulare, iar JVM-ul nu o găsește în niciun JAR de pe classpath. Mesajul conține numele complet căutat (pachet + clasă). Cazuri tipice:
Class.forName("com.mysql.cj.jdbc.Driver")sau un URL JDBC, fără dependența driverului înbuild.gradle.kts;- dependența e declarată doar pentru teste (
testImplementation) saucompileOnlyși lipsește la rulare; - numele clasei e scris greșit în cod sau în configurație;
- un JAR construit fără dependențe (rulat cu
java -jarfără fat-jar / shadow).
Eroarea înrudită NoClassDefFoundError apare când clasa exista la compilare, dar lipsește la rulare. Reparația e aceeași: verifică dependențele de rulare.
De ce apare: cauzele frecvente
1Driver JDBC fără dependență
// build.gradle.kts fără driver MySQL
Class.forName("com.mysql.cj.jdbc.Driver")// build.gradle.kts
dependencies {
runtimeOnly("com.mysql:mysql-connector-j:9.1.0")
}Clasa driverului vine din JAR-ul conectorului; fără el pe classpath, JVM-ul nu are de unde s-o încarce.
2Nume de clasă scris greșit
val tip = Class.forName("java.time.LocalDat")val tip = Class.forName("java.time.LocalDate")forName cere numele complet și exact, cu pachetul. O literă lipsă înseamnă altă clasă, inexistentă.
3Dependență doar pentru teste
dependencies {
testImplementation("org.postgresql:postgresql:42.7.4")
}dependencies {
implementation("org.postgresql:postgresql:42.7.4")
}testImplementation pune biblioteca doar pe classpath-ul testelor, nu și pe cel al aplicației.
Repară eroarea, direct în pagină
Programul încarcă după nume, ca dintr-un fișier de configurare, clasa folosită pentru date, dar numele e scris greșit și programul se oprește cu ClassNotFoundException: java.time.LocalDat. Corectează numele clasei ca programul să afișeze Clasa: LocalDate.
fun main() {
val numeClasa = "java.time.LocalDat"
val tip = Class.forName(numeClasa)
println("Clasa: ${tip.simpleName}")
}Clasa: LocalDate
Indiciu
Numele complet al clasei este java.time.LocalDate.
Reparația
fun main() {
val numeClasa = "java.time.LocalDate"
val tip = Class.forName(numeClasa)
println("Clasa: ${tip.simpleName}")
}De ce merge
Class.forName caută la rulare o clasă cu exact numele dat, în toate JAR-urile de pe classpath. java.time.LocalDat nu există, așa că JVM-ul a aruncat ClassNotFoundException cu numele căutat. Cu numele corect, clasa este găsită în biblioteca standard Java. Într-un proiect real, aceeași excepție apare când numele e corect, dar JAR-ul care conține clasa lipsește din dependențe.
Alte forme ale mesajului
Exception in thread "main" java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driverjava.lang.ClassNotFoundException: org.postgresql.Driverjava.lang.NoClassDefFoundError: kotlin/jvm/internal/IntrinsicsCaused by: java.lang.ClassNotFoundException: kotlin.jvm.internal.Intrinsics
Cum o eviți pe viitor
Declară dependențele de rulare în Gradle/Maven și verifică ce ajunge în aplicația finală (./gradlew dependencies). Pentru JAR-uri rulate cu java -jar, folosește un plugin de fat-jar (Shadow) sau application cu installDist; la Kotlin, JAR-ul trebuie să includă și biblioteca standard (altfel primești NoClassDefFoundError: kotlin/jvm/internal/Intrinsics). Evită Class.forName când poți folosi direct clasa: erorile se văd atunci la compilare.
Întrebări frecvente
Merge în IntelliJ, dar nu când rulez JAR-ul. De ce?
IntelliJ rulează cu tot classpath-ul proiectului. Un JAR simplu conține doar clasele tale; dependențele trebuie împachetate în el (fat-jar) sau puse pe classpath la rulare.
Mai e nevoie de Class.forName pentru JDBC?
De regulă nu: driverele moderne se înregistrează singure dacă sunt pe classpath. Dacă primești No suitable driver found, problema e tot lipsa driverului sau un URL JDBC greșit.
Erori înrudite
Exception in thread "main" java.lang.ExceptionInInitializerError O valoare de nivel superior (val în afara funcțiilor), un object sau un companion object a aruncat o excepție chiar când a fost inițializat. Uită-te la rândul „Caused by:” de sub mesaj: acolo e eroarea reală. Repar-o, sau mută calculul riscant într-o funcție ori în by lazy. Unresolved reference 'totl' Compilatorul nu găsește niciun nume totl: nu există o variabilă, funcție sau clasă cu numele ăsta în locul în care l-ai folosit. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau un import lipsă. Corectează numele sau declară-l. java.io.FileNotFoundException: date.txt (No such file or directory) Fișierul pe care vrei să-l citești nu există la calea dată, de cele mai multe ori pentru că o cale relativă e calculată față de alt folder decât crezi. Verifică directorul curent (File(".").absolutePath), folosește calea completă sau tratează lipsa fișierului cu exists() / try-catch. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
