Spring Boot 3 in Bestandsprojekten

Keine Zeit? Hier die Kurzversion in 30 Sekunden.
- Der sinnvolle Weg: erst auf Spring Boot 2.7 und Java 17, dann auf 3.0; 2.7 bekommt noch bis November 2023 kostenlose Updates, es eilt also nicht.
- Größter Brocken ist der Umzug von
javaxaufjakarta, vor allem wegen Bibliotheken, die noch nicht so weit sind.- Spring Security 6 verlangt eine
SecurityFilterChain-Bean,authorizeHttpRequestsundrequestMatchers; derWebSecurityConfigurerAdapterist weg.- Weitere Stolpersteine: Hibernate 6, deaktiviertes Trailing-Slash-Matching, umbenannte Properties, Micrometer Tracing statt Sleuth.
- Automatisierung mit OpenRewrite und der Properties-Migrator helfen, ein gutes Testnetz ist trotzdem unverzichtbar.
Im Dezember habe ich über die Neuerungen von Spring Boot 3.0 geschrieben, so wie man das eben tut, wenn ein Release frisch ist: Schlagwörter, Versprechen, Ausblick. Inzwischen habe ich ein Bestandsprojekt auf die neue Version gehoben, und die Lage sieht aus der Nähe etwas anders aus. Nicht schlechter, nur nüchterner. Hier mein Bericht, ohne Anspruch auf Vollständigkeit.
Zum Stand: Spring Boot 3.0 ist die aktuelle Linie und bekommt Patch-Releases. Für Mai ist 3.1 angekündigt, aber noch nicht erschienen, deshalb beziehe ich mich ausschließlich auf 3.0.x.
Erst langsam: über 2.7 und Java 17
Der erste Fehler, den man machen kann, ist der Sprung von einer alten 2.x-Version direkt auf 3.0. Spring Boot 3 setzt Java 17 voraus und baut auf Spring Framework 6 auf, das ist schon viel. Alles, was in 2.x als veraltet markiert war, ist jetzt entfernt. Wer vorher auf 2.7 geht, sieht die Warnungen noch als Warnungen und nicht als Fehler.
Mein Weg war deshalb:
- Auf die letzte 2.7.x-Version aktualisieren und alle Deprecation-Warnungen abarbeiten.
- Auf Java 17 umstellen, noch mit Boot 2.7. Das ist ein eigener Schritt mit eigener Fehlersuche: Bibliotheken, die tief in JDK-Interna greifen, mögen die stärkere Kapselung seit Java 16/17 nicht.
- Erst danach auf 3.0 gehen.
Das klingt nach mehr Aufwand, ist aber in der Praxis schneller, weil man bei einem Problem sofort weiß, welcher Schritt dafür verantwortlich ist. Und es ist kein Druck da: Spring Boot 2.7 bekommt nach heutigem Stand noch bis November 2023 kostenlose Updates. Wer diese Zeit nutzt, muss nicht im Hauruck-Verfahren umziehen.
javax wird jakarta
Der größte Brocken ist der Namensraum. Jakarta EE hat die Pakete umgezogen, und Spring Boot 3 baut auf Jakarta EE 10 auf. Aus javax.persistence.Entity wird jakarta.persistence.Entity, aus javax.servlet wird jakarta.servlet, aus javax.validation wird jakarta.validation.
Im eigenen Code ist das eine mechanische Aufgabe. Eine Suche und Ersetzung im Projekt geht schnell, die IDE kann es ebenfalls. Vorsicht bei javax-Paketen, die zum JDK gehören und nicht umziehen, etwa javax.crypto oder javax.net. Ein blindes Ersetzen über alles wäre hier ein Fehler.
Schwieriger wird es bei Bibliotheken. Alles, was gegen die Servlet-API oder JPA kompiliert ist, muss in einer Jakarta-Variante vorliegen. Viele Projekte haben das längst getan, andere bieten eine separate Version oder einen Klassifizierer an, und bei ein paar kleineren Bibliotheken musste ich nachsehen, ob sie überhaupt noch gepflegt werden. Mein Rat: vorher eine Liste aller Abhängigkeiten machen, die javax benutzen, und für jede klären, ob es eine Jakarta-Version gibt. Dabei reicht der Blick in die eigenen Quellen nicht, auch die Jars der Bibliotheken muss man prüfen. Wo es keine Lösung gibt, hat man vier Möglichkeiten: ersetzen, selbst pflegen, verzichten oder warten. Das letzte ist für ein Projekt, das ohnehin auf 2.7 bleiben darf, durchaus legitim.
Spring Security 6
Hier hat mich der Umbau am meisten Zeit gekostet. Die alte Konfiguration, die von WebSecurityConfigurerAdapter erbt, gibt es nicht mehr. Stattdessen definiert man eine SecurityFilterChain als Bean. Das war schon in 5.7 möglich, wer das vorher in der 2.7er-Phase umgestellt hat, spart sich Arbeit. Ein Beispiel in der neuen Form:
@Configuration
@EnableWebSecurity
public class SecurityConfig {
@Bean
SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
http
.authorizeHttpRequests(auth -> auth
.requestMatchers("/public/**").permitAll()
.requestMatchers("/admin/**").hasRole("ADMIN")
.anyRequest().authenticated())
.httpBasic(Customizer.withDefaults())
.csrf(csrf -> csrf.disable());
return http.build();
}
}Man sieht drei Dinge. Erstens die Lambda-DSL: Jede Konfigurationsgruppe bekommt ihren eigenen Block. Zweitens authorizeHttpRequests statt authorizeRequests, und drittens requestMatchers statt antMatchers oder mvcMatchers. Die alten Methoden sind entfernt. Und @EnableWebSecurity bringt in Version 6 kein @Configuration mehr mit, das muss man selbst dazuschreiben, sonst wird die Klasse nicht als Konfiguration erkannt.
Das CSRF-Abschalten im Beispiel gehört nicht zur Migration, ich habe es nur zur Veranschaulichung eingebaut. Ob man es abschalten darf, hängt davon ab, wie die Anwendung benutzt wird, und das ist keine Entscheidung, die man nebenbei trifft. Wichtig bei der Migration: Die Reihenfolge der Regeln zählt weiter, und ein Test pro geschütztem Pfad (anonym, angemeldet, falsche Rolle) ist die einzige Methode, die ich als wirklich verlässlich erlebt habe.
Hibernate 6 und die Folgen
Mit Boot 3 kommt Hibernate 6, und das ist kein harmloses Update. Ich halte mich hier bewusst allgemein, weil die Auswirkungen sehr vom Projekt abhängen. Aufgefallen sind mir drei Dinge: Die Auswertung von HQL-Abfragen ist strenger geworden, manche Abfragen, die bisher durchgingen, brechen mit Fehlern ab. Die Standardstrategien für ID-Generatoren haben sich geändert, was bei bestehenden Datenbanken zu Überraschungen führen kann, wenn Sequenzen anders benannt oder anders gezählt werden. Und einige Typzuordnungen sind anders, besonders bei Datums-, Zeit- und Sonderfällen.
Mein Rat: Datenbankzugriffe haben mit Abstand den höchsten Anteil am Risiko. Ich würde hier gezielt Integrationstests schreiben, gegen eine echte Datenbank und nicht nur gegen eine In-Memory-Variante, und die Migrationshinweise von Hibernate vorher lesen, nicht erst, wenn es knallt.
Kleinere Stolpersteine
Ein paar Dinge, die für sich genommen klein sind, in der Summe aber Zeit fressen:
- Trailing Slash: Das Matching mit abschließendem Schrägstrich ist standardmäßig aus. Ein Endpunkt
/fooantwortet nicht mehr auf/foo/. Für interne Clients mit fest verdrahteten URLs oder Skripte fällt das erst im Betrieb auf. Wer es braucht, muss es ausdrücklich zulassen oder die Aufrufer anpassen. - Properties: Einige Konfigurationsschlüssel wurden umbenannt oder entfernt. Die Abhängigkeit
spring-boot-properties-migratormeldet beim Start, welche Schlüssel betroffen sind, und biegt manche zur Laufzeit um. Ich nehme sie nur für die Umstellung dazu und entferne sie wieder. - Tracing: Spring Cloud Sleuth ist mit Boot 3 nicht mehr dabei. An seine Stelle tritt Micrometer Tracing. Wer Sleuth benutzt hat, muss Abhängigkeiten und Konfiguration anfassen, und die Dokumentation dazu liest man besser einmal gründlich.
- Sonstiges: Neue Mindestversionen bei Tomcat und anderen Servern, veränderte Standardwerte, hier und da ein Starter, der anders heißt.
Automatisieren, wo es geht
Wer mehrere Projekte hat, sollte sich OpenRewrite ansehen. Das Werkzeug arbeitet mit Rezepten, die Quellcode, Build-Dateien und Konfiguration automatisch umbauen. Für Spring Boot gibt es fertige Rezepte für die Migration auf 3.0, die unter anderem Imports von javax auf jakarta umziehen und Properties anpassen. Ich habe sie nicht blind übernommen, sondern als Vorschlag laufen lassen und den Diff gelesen. Das spart den langweiligen Teil und lässt mir die Entscheidungen.
Das alles funktioniert nur mit einem Sicherheitsnetz. Hätte das Projekt keine brauchbaren Tests gehabt, wäre ich mit der Migration vorsichtiger umgegangen oder hätte zuerst Tests geschrieben. Ein Update ohne Tests ist am Ende ein Ratespiel.
Was ich daraus mitnehme
Die Migration war machbar, aber nicht nebenbei zu erledigen. Der Aufwand lag weniger in Spring selbst als in den Rändern: Bibliotheken, Datenbankzugriff, Sicherheitskonfiguration. Die Reihenfolge hilft mehr als jeder Trick, und wer den Zwischenschritt über 2.7 einplant, hat deutlich weniger Überraschungen.
Ob man jetzt oder später umzieht, hängt am Nutzen. Wer Native Images, die neue Observability oder die längere Support-Perspektive braucht, hat einen Grund. Wer ein stabiles System auf 2.7 betreibt, kann sich Zeit lassen, sollte den Termin im November aber im Kalender haben.
Wie sind eure Erfahrungen? Mich würde vor allem interessieren, welche Bibliotheken bei euch mit Jakarta Probleme gemacht haben.
Beitragsbild: Foto Sanierung eines Altbaus, Amsterdam von Fons Heijnsbroek, CC0 (via Wikimedia Commons; zugeschnitten auf 16:9).
Christian Ackermann
Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.