...
Eroare Kotlin · Excepții la rulare

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

Pe scurt

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 în build.gradle.kts;
  • dependența e declarată doar pentru teste (testImplementation) sau compileOnly ș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 -jar fă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ță

Greșit
KOTLIN
// build.gradle.kts fără driver MySQL
Class.forName("com.mysql.cj.jdbc.Driver")
Corect
KOTLIN
// 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

Greșit
KOTLIN
val tip = Class.forName("java.time.LocalDat")
Corect
KOTLIN
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

Greșit
KOTLIN
dependencies {
    testImplementation("org.postgresql:postgresql:42.7.4")
}
Corect
KOTLIN
dependencies {
    implementation("org.postgresql:postgresql:42.7.4")
}

testImplementation pune biblioteca doar pe classpath-ul testelor, nu și pe cel al aplicației.

Repară tu

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.

Codul care dă eroarea
KOTLIN
fun main() {
    val numeClasa = "java.time.LocalDat"
    val tip = Class.forName(numeClasa)
    println("Clasa: ${tip.simpleName}")
}
După reparație, programul afișează
Clasa: LocalDate
Indiciu

Numele complet al clasei este java.time.LocalDate.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver
  • java.lang.ClassNotFoundException: org.postgresql.Driver
  • java.lang.NoClassDefFoundError: kotlin/jvm/internal/Intrinsics
  • Caused 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

← Toate erorile Kotlin

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ță 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.