Tutorial: Fehler "package javax.servlet does not exist" in Apache Tomcat 10 beheben

Melden

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.

  1. Gehe in deinen Tomcat 10 Installationsordner.
  2. Öffne den Unterordner lib.
  3. Suche die Datei servlet-api.jar (oder jakarta.servlet-api.jar).
  4. In Eclipse: Rechtsklick auf das Projekt -> Build Path -> Configure Build Path -> Libraries -> Add External JARs -> Wähle die Datei aus dem Tomcat-lib-Ordner.
  5. 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:

  1. Lade das Apache Tomcat Migration Tool for Jakarta EE herunter.
  2. Dieses Tool konvertiert eine alte .war-Datei automatisch, indem es alle javax-Referenzen in den Binärdateien durch jakarta ersetzt.
  3. 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!

0