Wenn Ihr Team noch Java 8 oder 11 mit Spring Boot 2 betreibt, steht dieses Upgrade vermutlich schon länger im Backlog. Gegen das nächste Kundenfeature verliert es jedes Mal, denn das System läuft, und ein Upgrade lässt sich in keiner Demo zeigen.
Das Problem: Die Kosten des Abwartens steigen leise. Jeden Monat liefern mehr der Bibliotheken, auf die Sie sich stützen, Fehlerbehebungen nur noch für den neuen Stack, und der Sprung, den Sie irgendwann machen müssen, wird ein Stück größer.
Dieser Artikel richtet sich an Engineering Manager und CTOs, die diesen Sprung planen müssen. Er erklärt, warum jetzt ein guter Zeitpunkt ist, was tatsächlich bricht, wie Sie die Arbeit in Etappen zerlegen, die jeweils in Produktion gehen, und wie Sie den Aufwand aus Ihrem eigenen Code ableiten statt aus einer Faustregel.
1. Warum das Upgrade keine Kür mehr ist
Spring Boot 3 setzt mindestens Java 17 voraus und baut auf Jakarta EE auf. Der Open-Source-Support für Spring Boot 2 ist ausgelaufen. Sicherheitsupdates für das Framework unter Ihrer Anwendung erscheinen also nur noch für die 3.x-Linie, es sei denn, Sie bezahlen erweiterten kommerziellen Support. Oracle hat die kostenlosen öffentlichen Updates für Java 8 im kommerziellen Einsatz schon vor Jahren eingestellt. Andere Distributionen liefern zwar weiterhin gepatchte Builds von 8 und 11, aber das Ökosystem zieht weiter: Neue Versionen von Treibern, SDKs und Bibliotheken zielen zunehmend nur noch auf Java 17 und Spring Boot 3.
Dazu kommt die Personalseite. Erfahrene Spring-Entwicklerinnen und -Entwickler erwarten einen aktuellen Stack, und wer in einer Stellenanzeige Java 8 liest, fragt sich, was sonst noch veraltet ist. Auf der anderen Seite warten echte Vorteile. Java 21 ist ein LTS-Release mit Virtual Threads, Records und Pattern Matching, und ab Spring Boot 3.2 lassen sich Requests per Konfigurationsschalter auf Virtual Threads verarbeiten. Für Services, die den Großteil ihrer Zeit auf Datenbanken und andere APIs warten, kann das mehr parallele Requests auf derselben Hardware bedeuten. Messen Sie das mit Ihrer eigenen Last, bevor Sie es einplanen.
Für Führungskräfte: Wer auf Spring Boot 2 bleibt, betreibt sein System ohne Sicherheitsupdates aus dem Upstream. Behandeln Sie das Upgrade als Pflichtwartung und die neuen Funktionen als Zugabe.
2. Der Wechsel von javax zu jakarta reicht weiter als gedacht
Jakarta EE hat die Pakete umbenannt: Aus javax.persistence wurde jakarta.persistence, aus javax.servlet wurde jakarta.servlet, aus javax.validation wurde jakarta.validation und so weiter. Spring Boot 3 verwendet durchgängig die neuen Namen. Im eigenen Quellcode ist die Änderung überwiegend Suchen und Ersetzen, und Werkzeuge wie OpenRewrite automatisieren einen großen Teil davon.
Schwieriger ist alles, was Sie nicht selbst geschrieben haben. Jede Bibliothek, die mit Servlets, Persistenz oder Validierung arbeitet, braucht eine Version für jakarta, und manche haben nie eine bekommen. Springfox, ein verbreiteter Weg zur Swagger-Dokumentation, funktioniert mit Spring Boot 3 nicht; üblich ist der Umstieg auf springdoc-openapi 2. Spring Cloud Sleuth wurde durch Micrometer Tracing ersetzt. RestTemplate-Konfigurationen auf Basis von Apache HttpClient 4 brauchen HttpClient 5. Wer WAR-Dateien auf einen externen Tomcat deployt, muss auch diesen Server auf eine jakarta-fähige Version heben. Vorsicht: Einige javax-Pakete wie javax.sql und javax.crypto gehören zum JDK und bleiben unverändert. Ein blindes Ersetzen über die gesamte Codebasis richtet deshalb eigenen Schaden an.
Für Führungskräfte: Listen Sie vor jeder Schätzung alle Fremdabhängigkeiten auf und prüfen Sie, ob es ein jakarta-kompatibles Release gibt. Die Bibliotheken ohne ein solches bestimmen Ihren Zeitplan.
3. Security, Hibernate und das JDK selbst
Spring Security 6 hat WebSecurityConfigurerAdapter entfernt. Die Sicherheitskonfiguration ist jetzt eine SecurityFilterChain-Bean, aus antMatchers wurde requestMatchers und aus authorizeRequests wurde authorizeHttpRequests. Der Umbau ist meist kurz. Ein Fehler kann aber unbemerkt einen Endpunkt öffnen oder sperren, deshalb braucht jede Zugriffsregel einen Test, der belegt, wer sie erreicht und wer nicht. Außerdem wertet Spring Framework 6 einen abschließenden Schrägstrich standardmäßig nicht mehr als Treffer: Ein Client, der /orders/ aufruft, landet nicht mehr bei einem Controller, der auf /orders gemappt ist.
Hibernate 6 kommt mit Spring Boot 3. Der Query-Parser ist strenger, sodass HQL, das ältere Versionen toleriert haben, beim Start scheitern oder sich anders verhalten kann. Eigene Spaltentypen, die ID-Generierung und manche nativen Queries gehören auf den Prüfstand. Auf JDK-Seite hat Java 11 die früher mitgelieferten Java-EE-Module entfernt (darunter JAXB und JAX-WS), und Java 17 kapselt JDK-Interna strikt, sodass Bibliotheken, die per Reflection darauf zugegriffen haben, ausfallen. Auch das Build-Tooling muss mitziehen: Ältere Versionen von Lombok, Mockito, JaCoCo und diversen Maven- oder Gradle-Plugins kommen mit neueren Class-Files nicht zurecht.
Für Führungskräfte: Die riskanten Änderungen stecken in der Security-Konfiguration und in den Datenbank-Queries. Sorgen Sie dafür, dass beides durch Tests abgedeckt ist, bevor Sie es anfassen.
4. Zuerst das Sicherheitsnetz
Ein Upgrade ohne Tests ist eine Wette, deren Ausgang Sie in Produktion erfahren. Volle Testabdeckung brauchen Sie zum Start nicht. Abgedeckt sein müssen die Abläufe, bei denen ein Fehler wehtut: Login und Berechtigungen, die wichtigsten Schreibpfade, Abrechnung oder Zahlungen, falls vorhanden, und die Schnittstellen, von denen andere Systeme abhängen.
Wo Unit-Tests dünn sind, schreiben Sie ein paar breite Tests, die die echte API aufrufen und die Antwort prüfen. Sie sind grob, finden aber ein geändertes JSON-Feld, einen fehlenden Header oder eine Query, die andere Zeilen liefert. Eine grüne Pipeline, die diese Tests bei jedem Commit ausführt, ist der beste Indikator für ein ruhiges Upgrade.
Für Führungskräfte: Investieren Sie den ersten Teil des Budgets in Tests für die wichtigsten Abläufe. Alles danach wird günstiger.
5. In Etappen migrieren, jede davon in Produktion
Eine Reihenfolge, die sich bewährt, sieht so aus. Bringen Sie zuerst Spring Boot 2 auf die letzte Release-Linie 2.7 und Java auf Version 17, auf der 2.7 läuft. So trennen Sie JDK-Probleme von Framework-Problemen. Beseitigen Sie dann, noch auf 2.7, die Deprecation-Warnungen und stellen Sie die Security-Konfiguration auf den SecurityFilterChain-Stil um, den 2.7 bereits unterstützt. Danach folgt der eigentliche Sprung auf Spring Boot 3, den jakarta-Namensraum und Hibernate 6, wobei das Modul spring-boot-properties-migrator umbenannte Properties meldet. Zum Schluss stellen Sie die Laufzeit auf Java 21 um und entscheiden anhand von Messungen, ob Virtual Threads Ihrer Last helfen.
Jede Etappe geht bis in Produktion und läuft dort eine Weile, bevor die nächste beginnt. Wenn etwas bricht, wissen Sie, welche Etappe es war, und ein Rollback ist ein kleiner Schritt statt eines verlorenen Quartals. Bei mehreren Services migrieren Sie zuerst einen Service mit geringem Risiko komplett und übertragen die Erkenntnisse dann auf die übrigen.
Für Führungskräfte: Bündeln Sie nie Java-Upgrade, Spring-Boot-Upgrade und neue Features in einem Release. Kleine Schritte machen jeden Fehler leicht nachvollziehbar.
6. Den Aufwand aus dem eigenen Code ableiten
Eine Zahl von Wochen pro tausend Zeilen nennen wir Ihnen nicht, denn die Größe der Codebasis ist nur ein Faktor und oft nicht der wichtigste. Die Schätzung bewegen vor allem die Anzahl der Module oder Services, die Zahl der Abhängigkeiten ohne jakarta-Version, der Umfang an eigenem Security- und Hibernate-Code und die Qualität der Testabdeckung.
Am verlässlichsten finden Sie das mit einem kurzen, zeitlich begrenzten Spike heraus. Lassen Sie die automatischen Migrationsrezepte auf einem Branch laufen, kompilieren Sie, führen Sie die Tests aus und zählen Sie, was übrig bleibt: Compile-Fehler, rote Tests, Bibliotheken ohne Upgrade-Pfad. Aus einer vagen Sorge wird so ein Backlog, das sich schätzen lässt. Wenn im Team niemand Zeit für den Spike hat, leistet ein technisches Assessment mit festem Umfang dasselbe von außen. Wir lesen die Java-Codebasis, die Pipeline und die Sicherheitslage und halten die Ergebnisse schriftlich fest: was bleiben kann, was zuerst modernisiert werden sollte und was es kosten wird.
Für Führungskräfte: Stützen Sie die Schätzung auf einen Spike gegen Ihren echten Code. Ein Plan auf Basis der tatsächlichen Bruchstellen schlägt jede Faustregel.
7. Features liefern, während das Upgrade läuft
Am schlechtesten migriert man auf einem langlebigen Branch, der sich jede Woche weiter vom Main-Branch entfernt, während das Produktteam weiter ausliefert. Führen Sie die Upgrade-Arbeit stattdessen in kleinen Stücken in den Main-Branch zusammen. Die meisten frühen Etappen, von neuen Tests über Java 17 bis zur bereinigten Security-Konfiguration, sind mit dem alten Stack kompatibel und können neben den normalen Features ausgeliefert werden.
Der Sprung auf jakarta ist die einzige Änderung, die pro Service wirklich auf einmal kommen muss. Halten Sie dieses Fenster kurz, indem Sie alles andere vorher erledigen, und vereinbaren Sie mit dem Produktteam ein paar Tage, an denen Änderungen an diesem Service ruhen. Manche Teams geben das Upgrade an eine kleine Gruppe oder ein externes Team, damit alle anderen ihr Tempo halten. So geht CS2 an Modernisierung heran: Auf der Plattform der Vodafone Kabel Deutschland liefen die Migration von Java EE 7 zu Spring Boot und der Wechsel von OAuth 1.0 zu JWT im laufenden Betrieb, während Außendiensttechniker das System jeden Tag weiter nutzten. Unsere eigenen Produkte Notermed und GWS Connect laufen auf Java-17-APIs mit Spring Boot, den Upgrade-Pfad gehen wir also auch in unserem eigenen Code.
Für Führungskräfte: Klein und häufig zusammenführen, und den einen echten Umstieg pro Service in ein kurzes, angekündigtes Fenster legen.
Kurz gesagt
Spring Boot 2 hat keinen Open-Source-Support mehr, und Spring Boot 3 verlangt Java 17 und den jakarta-Namensraum. Die schwierigen Stellen sind Fremdbibliotheken, Security-Konfiguration und Hibernate-Queries, also gehören dort zuerst Tests hin. Migrieren Sie in Etappen, die jeweils in Produktion gehen, schätzen Sie auf Basis eines Spikes gegen Ihren echten Code und liefern Sie weiter aus, indem Sie kleine Änderungen in den Main-Branch zusammenführen.