Tutorial: Fehler "package javax.servlet does not exist" in Apache Tomcat 10 beheben
Hier ist ein ausführliches Tutorial, wie du den Fehler "package javax.servlet does not exist" speziell für Apache Tomcat 10 behebst.
Wenn du von einer älteren Tomcat-Version auf Tomcat 10 umsteigst, wirst du feststellen, dass dein Code plötzlich nicht mehr kompiliert oder Servlets nicht gefunden werden. Der Grund dafür ist eine der größten Änderungen in der Geschichte von Java Enterprise: Der Wechsel von Java EE zu Jakarta EE.
Die Ursache des Problems
Seit der Version 10 von Apache Tomcat wurde der Namespace von javax.* auf jakarta.* umgestellt.
- Tomcat 9 und älter: Verwendet das Package
javax.servlet. - Tomcat 10 und neuer: Verwendet das Package
jakarta.servlet.
Daher findet Tomcat 10 die alten javax-Bibliotheken nicht mehr in seinem internen Klassenpfad.
Lösung 1: Den Quellcode anpassen (Empfohlen)
Dies ist der sauberste Weg. Du musst alle Import-Anweisungen in deinen Java-Dateien aktualisieren.
Suche nach:
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.*;
Ersetze es durch:
import jakarta.servlet.*;
import jakarta.servlet.http.*;
import jakarta.servlet.annotation.*;
Hinweis: Dies gilt für alle Java EE-Pakete (z. B. wird auch javax.persistence zu jakarta.persistence).
Lösung 2: Abhängigkeiten in Maven oder Gradle aktualisieren
Falls du ein Build-Tool verwendest, musst du die entsprechenden Bibliotheken importieren, damit dein Compiler die Klassen findet.
Für Maven (pom.xml):
Entferne die alte javax.servlet-api und füge die neue Jakarta-Dependency hinzu:
<dependency>
<groupId>jakarta.servlet</groupId>
<artifactId>jakarta.servlet-api</artifactId>
<version>6.0.0</version> <!-- oder eine aktuelle Version -->
<scope>provided</scope>
</dependency>
Für Gradle (build.gradle):
dependencies {
compileOnly 'jakarta.servlet:jakarta.servlet-api:6.0.0'
}
Lösung 3: Die Servlet-API manuell im IDE hinzufügen
Falls du kein Maven/Gradle nutzt, musst du die JAR-Datei manuell in dein Projekt einbinden, damit die IDE (Eclipse, IntelliJ) den Fehler nicht mehr anzeigt.
- Gehe in deinen Tomcat 10 Installationsordner.
- Öffne den Unterordner
lib. - Suche die Datei
servlet-api.jar(oderjakarta.servlet-api.jar). - In Eclipse: Rechtsklick auf das Projekt -> Build Path -> Configure Build Path -> Libraries -> Add External JARs -> Wähle die Datei aus dem Tomcat-lib-Ordner.
- In IntelliJ: File -> Project Structure -> Libraries ->
+Zeichen -> Wähle die Datei aus dem Tomcat-lib-Ordner.
Lösung 4: Das Tomcat Migration Tool (für fertige .war-Dateien)
Wenn du eine fertige Web-Anwendung (.war) hast, die für Tomcat 9 geschrieben wurde und deren Quellcode du nicht ändern kannst, bietet Apache ein Tool an:
- Lade das Apache Tomcat Migration Tool for Jakarta EE herunter.
- Dieses Tool konvertiert eine alte
.war-Datei automatisch, indem es allejavax-Referenzen in den Binärdateien durchjakartaersetzt. - Platziere die konvertierte Datei einfach in den
webapps-Ordner von Tomcat 10.
Zusammenfassung
Um den Fehler in Tomcat 10 zu beheben, musst du lediglich das Präfix javax. durch jakarta. in deinen Importen ersetzen und sicherstellen, dass deine Build-Konfiguration die neue Jakarta-Servlet-API verwendet. Damit ist dein Projekt bereit für die moderne Java-Webentwicklung!