Öffnet man einen aufgeblähten Redux-Store, findet man meist keinen Clientzustand: Bestelllisten, Benutzerdatensätze, isLoading-Flags, manuell gepflegte lastFetched-Zeitstempel. All das sind Kopien von Daten, die auf dem Server leben, und der Store wird zu einem Codeberg, um sie aktuell und konsistent zu halten. Die Frage „Welche State-Bibliothek sollen wir wählen?“ wird daher an der falschen Stelle gestellt. Trennen Sie zuerst den Zustand nach Arten, die Werkzeugwahl folgt danach.
Zustandsarten trennen
Ordnen Sie, bevor Sie in die Bibliotheksdiskussion einsteigen, jedes Zustandsstück der Anwendung einer der folgenden vier Klassen zu. Diese Trennung ist entscheidender als das gewählte Werkzeug.
| Typ | Eigentlicher Besitzer | Beispiel | Geeignetes Werkzeug |
|---|---|---|---|
| Serverzustand | Backend / API | Bestellliste, Benutzerprofil | TanStack Query, SWR |
| URL-Zustand | Adressleiste | Filter, Seitennummer, Sortierung, ausgewählte Registerkarte | Suchparameter des Routers |
| Formularzustand | Formularkomponente | Bearbeitete Felder, Validierungsfehler | React Hook Form, lokaler State |
| Client-(UI-)Zustand | Browsersitzung | Offenes Modal, Theme, Warenkorbentwurf | useState, Context, Zustand, Redux Toolkit |
Serverzustand unterscheidet sich grundlegend von den anderen drei: Andere können ihn ändern, er kann veralten, während Sie auf den Bildschirm schauen, und er kommt asynchron. Sie verwalten ihn nicht wie eine Variable, sondern wie einen Cache einer entfernten Quelle. Um die Klasse eines Werts zu bestimmen, genügt eine Frage: „Woher soll dieser Wert zurückkommen, wenn ich die Seite neu lade?“ Lautet die Antwort API, ist es Serverzustand, bei der Adressleiste URL-Zustand, und wenn er von nirgendwo zurückkommen soll, Clientzustand. Stellen Sie diese Frage jedem Slice im Store. Die Tabelle füllt sich von selbst.
Serverzustand und Bibliotheken für Datencaching
TanStack Query und SWR cachen Serverdaten unter einem Schlüssel (Query Key). Sie verwalten für Sie Lade- und Fehlerzustände, Neuvalidierung im Hintergrund, das Zusammenführen gleichzeitiger Anfragen (Deduplication) und die Invalidierung nach Änderungen. Ein wesentlicher Teil des Codes, der in Redux die Felder isLoading, error, lastFetched manuell pflegt, entfällt mit diesen Bibliotheken.
// Bestellliste und Aktualisierung mit TanStack Query v5
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
export function useOrders(filters: { status: string; page: number }) {
return useQuery({
queryKey: ['orders', filters], // Filter sind Teil des Schluessels
queryFn: () => api.get('/orders', { params: filters }),
staleTime: 30_000, // 30 s lang als frisch betrachten
});
}
export function useApproveOrder() {
const qc = useQueryClient();
return useMutation({
mutationFn: (id: string) => api.post(`/orders/${id}/approve`),
onSuccess: () => qc.invalidateQueries({ queryKey: ['orders'] }),
});
}
In diesem Code bestimmen drei Einstellungen das Ergebnis. Design des Query Keys: Gehen Filter nicht in den Schlüssel ein, überschreiben sich die Ergebnisse verschiedener Filter gegenseitig; der Benutzer wechselt zur Registerkarte „Freigegeben“, sieht aber kurz die „offenen“ Bestellungen. staleTime: Der Standard ist null, Daten gelten sofort als „veraltet“ und werden im Hintergrund erneut abgerufen, wenn die Komponente neu eingebunden wird, der Fensterfokus zurückkehrt oder die Netzverbindung wiederhergestellt wird. Bei selten wechselnden Referenzdaten wie Länderlisten oder Produktkategorien verhindert ein höherer Wert unnötige Anfragen. Umfang der Invalidierung: Die Invalidierung mit dem Präfix ['orders'] erneuert alle Filterkombinationen; ein engerer Schlüssel ist möglich, erhöht aber das Risiko von Inkonsistenz.
In Next.js-App-Router-Projekten wird ein Teil der Daten in Server Components abgerufen und kommt nie als State zum Client. Dann wird eine clientseitige Query-Bibliothek nur in interaktiven Bereichen gebraucht: Infinite Scroll, Live-Filter, Aktualisierung nach Mutationen. Wo die Grenze gezogen wird, beschreibt der Leitfaden Trennung von Server und Client Component im Next.js App Router ausführlich.
Wann sollte ein optimistisches Update verwendet werden?
Bei Vorgängen, die sofortiges Feedback erwarten, wie Freigabe-Button, Sternchen setzen oder Sortierung ändern, aktualisiert ein optimistisches Update (Optimistic Update) die Oberfläche, ohne auf die Serverantwort zu warten, und nimmt die Änderung bei einem Fehler zurück. Bei Vorgängen, die Betrag, Bestand oder Berechtigung ändern, warten Sie auf die Serverantwort. Dem Benutzer „freigegeben“ anzuzeigen und es zwei Sekunden später zurückzunehmen, erschüttert in Geschäftsprozessen das Vertrauen. Bei Geld gibt es keinen Optimismus.
URL- und Formularzustand
Werden in Listenbildschirmen von Unternehmens-Geschäftsanwendungen Filter, Seitennummer und Sortierung in einen globalen Store gelegt, kommen drei Beschwerden: Ein geteilter Link öffnet nicht dieselbe Ansicht, die Zurück-Taste des Browsers funktioniert nicht wie erwartet, und nach dem Neuladen beginnt der Benutzer von vorn. Die beim Support eingehende Meldung „Ich habe den Link geschickt, aber die Gegenseite sieht eine andere Liste“ hat meist diese Ursache. Der natürliche Ort dieser Informationen ist die URL.
// React Router v6: Filter in der URL halten
// (in v7 kann derselbe Hook auch aus dem Paket 'react-router' importiert werden)
import { useSearchParams } from 'react-router-dom';
function OrderFilters() {
const [params, setParams] = useSearchParams();
const status = params.get('status') ?? 'open';
const page = Number(params.get('page') ?? '1');
const { data } = useOrders({ status, page }); // Liste wird in separater Komponente gerendert
return (
<select
value={status}
onChange={(e) => setParams({ status: e.target.value, page: '1' })}
>
<option value="open">Offen</option>
<option value="approved">Freigegeben</option>
</select>
);
}
URL-Parameter sind Text. Setzen Sie bei der Umwandlung in Zahl, Datum oder Liste ungültige Werte auf den Standard zurück; ein manuell eingetipptes ?page=abc darf den Bildschirm nicht abstürzen lassen. In Next.js wird dasselbe Muster mit useSearchParams und useRouter umgesetzt, im App Router zusätzlich serverseitig über die Eigenschaft searchParams der Seitenkomponente (ab Next.js 15 kommt diese Eigenschaft als Promise und muss mit await abgewartet werden).
Formularzustand ist kurzlebig: Er existiert, solange das Formular offen ist, und verliert nach dem Absenden seine Bedeutung. Jeden Tastendruck in einen globalen Store zu schreiben, erzeugt unnötiges Neurendern und auf Bildschirmen mit mehreren offenen Formularen auch Konflikte. Bibliotheken wie React Hook Form halten Feldwerte innerhalb der Komponente; das Senden an den Server ist eine Mutation und gehört in die Serverzustandsschicht. Validierungsregeln zwischen Client und Server zu vereinheitlichen, ist Thema des Leitfadens Formularvalidierung mit einem einzigen Schema verwalten.
Optionen für globalen Clientzustand
Nach der Trennung der drei Arten ist der verbleibende echte Clientzustand meist klein: UI-Präferenzen des Benutzers, Theme, offene Seitenleiste, Entwurf eines mehrstufigen Assistenten, lokaler Warenkorb. Die Optionen:
useState/useReducerund Zustand nach oben heben: Nutzen einige Komponenten den Zustand, ist das die erste Wahl. Gibt es komplexe Übergänge, machtuseReducerdie Logik testbar.- Context: Ein Mechanismus, einen Wert ohne Prop-Weitergabe im Baum zu verteilen, keine State-Management-Bibliothek. Ändert sich ein Context-Wert, werden alle Komponenten, die ihn lesen, neu gerendert. Für selten wechselnde Werte wie Theme, Sprache oder Sitzungsinformationen geeignet; bei häufig wechselnden Werten entstehen Performanceprobleme.
- Zustand: Ein Store mit kleiner API, der keinen Provider braucht. Komponenten abonnieren per Selector nur den benötigten Teil; bei unbeteiligten Änderungen wird kein Render ausgelöst.
- Redux Toolkit: Bietet strengen unidirektionalen Datenfluss, Time Travel mit Redux DevTools, ein Middleware-Ökosystem und mit RTK Query integrierte Serverzustandsverwaltung. In großen Teams liefert es Vorhersehbarkeit und Nachvollziehbarkeit; im Gegenzug verlangt es mehr Struktur.
// Zustand: per Selector abonnieren
import { create } from 'zustand';
type UiState = { sidebarOpen: boolean; toggleSidebar: () => void };
export const useUi = create<UiState>()((set) => ({
sidebarOpen: true,
toggleSidebar: () => set((s) => ({ sidebarOpen: !s.sidebarOpen })),
}));
// Die Komponente rendert nur, wenn sich sidebarOpen aendert
const open = useUi((s) => s.sidebarOpen);
Vergleichstabelle der Bibliotheken
| Kriterium | Context | Zustand | Redux Toolkit |
|---|---|---|---|
| Zusätzliche Abhängigkeit | Keine | Klein | Mittel (RTK + react-redux) |
| Teilabonnement per Selector | Nein (durch Aufteilen des Context) | Vorhanden | Ja (useSelector) |
| DevTools / Nachverfolgung | React DevTools | Redux DevTools per Middleware | Eingebaut |
| Unterstützung für Serverzustand | Keine | Nein (zusammen mit Query) | RTK Query |
| Passende Größe | Einige selten wechselnde Werte | Kleiner bis mittlerer Clientzustand | Großes Team, komplexe Geschäftsregeln |
Die Entscheidungsreihenfolge funktioniert in der Praxis so: Bestimmen Sie zuerst die Klasse des Zustands; geben Sie Serverzustand an die Query-Bibliothek und URL-Zustand an den Router. Liegt der verbleibende Clientzustand innerhalb eines Bildschirms, genügt lokaler State. Ist er anwendungsweit und ändert sich selten, passt Context; ändert er sich häufig und lesen ihn viele Komponenten, passt Zustand. Hat das Team bereits in Redux Toolkit investiert und will den Serverzustand mit RTK Query unter einem Dach halten, ist es günstiger, die bestehende Struktur zu vereinfachen, statt die Bibliothek zu wechseln. Ein Rewrite ist meist der teuerste Weg.
Zur Auswirkung der API-Wahl auf den Client-Cache siehe den Vergleich REST oder GraphQL; da GraphQL-Clients (z. B. Apollo Client) ihren eigenen normalisierten Cache mitbringen, wird eine separate Query-Bibliothek eventuell nicht gebraucht.
Schritte aus übermäßigem globalem Zustand heraus
Den über Jahre gewachsenen Redux-Store einer Unternehmens-Webanwendung auf einen Schlag neu zu schreiben, gleicht dem Austausch des Core-Switches in einem Livesystem während der Geschäftszeit. Die folgende Reihenfolge kommt voran, ohne Funktionen zu brechen, und hält den Rückweg offen.
- Inventar erstellen. Listen Sie jeden Slice im Store auf und ordnen Sie ihn einer der vier Klassen zu. In den meisten Projekten zeigt sich, dass Listen, Detaildatensätze und Lade-Flags Serverzustand sind.
- Query-Bibliothek daneben einrichten. Fügen Sie den
QueryClientProvidervon TanStack Query zusammen mit dem Redux-Providerhinzu. Beide Systeme können eine Weile nebeneinander laufen. - Leseendpunkte einzeln verlagern. Beginnen Sie mit dem einfachsten Listenbildschirm: Ersetzen Sie das Trio aus Thunk, Reducer und Selector durch einen
useQuery-Hook. Prüfen Sie vor dem Löschen des Slices per Codesuche, dass keine andere Stelle ihn liest. - Mutationen verlagern. Übernehmen Sie Speicher- und Freigabevorgänge in
useMutation; invalidieren Sie nach Erfolg die betreffenden Abfragen, statt den Store manuell zu aktualisieren. - Filter in die URL verlagern. Verschieben Sie Filter- und Paginierungsinformationen aus dem Store in die Suchparameter; Deep Links und das Verhalten der Zurück-Taste korrigieren sich von selbst.
- Verbleibenden Clientzustand verkleinern. Bleiben einige UI-Slices übrig, ist es Teamentscheidung, sie in Redux zu lassen oder zu Zustand zu verlagern. Ziel ist nicht eine Bibliothek, sondern ein schlankes Zustandsmodell.
Häufige Fehler
- Serverdaten kopieren: Das ist der Fehler, den wir in der Praxis am häufigsten sehen. Das Ergebnis von
useQueryinuseEffectin einen separaten State zu schreiben, schafft zwei Quellen der Wahrheit, und eine bleibt zwangsläufig zurück. Berechnen Sie abgeleitete Werte beim Rendern oder nutzen Sie die Optionselect. - Ableitbare Werte speichern: Gesamtbetrag, gefilterte Liste oder Anzahl ausgewählter Elemente werden nicht separat gehalten, wenn sie aus anderem State berechnet werden können.
- Ein riesiger Context: Benutzer, Theme, Benachrichtigungen und Warenkorb in denselben Context-Wert zu legen, führt dazu, dass bei einer Änderung die ganze Anwendung neu rendert. Teilen Sie Contexts nach Verantwortung auf.
- Fehlender Parameter im Query Key: Jede Variable, die die Anfragefunktion nutzt, muss im Schlüssel stehen; das ESLint-Plugin von TanStack Query (
@tanstack/eslint-plugin-query) enthält eine Regel, die diesen Fehler erkennt.
Gehen Sie während der Migration nicht ohne Messung voran. Vergleichen Sie mit dem React DevTools Profiler auf kritischen Bildschirmen Zahl und Dauer der Renders vorher und nachher; suchen Sie im Netzwerk-Tab des Browsers nach doppelten Anfragen an denselben Endpunkt. Wird derselbe Endpunkt beim Öffnen einer Seite dreimal aufgerufen, ist der Cache-Schlüssel falsch. Damit Typdefinitionen und Ordnergrenzen der Zustandsschicht teamweit konsistent bleiben, wenden Sie mit dieser Arbeit den Ansatz zu Modulgrenzen aus dem Leitfaden Standards für TypeScript-Codebasen an.
Um die Zustandsschicht einer bestehenden React-Anwendung zu vereinfachen oder diese Trennung in einem neuen Projekt von Anfang an aufzubauen, führen wir im Rahmen von Webanwendungen mit React und Next.js Architekturbewertungen durch. Primärquellen für den konzeptionellen Hintergrund sind der Abschnitt Managing State der React-Dokumentation und die TanStack-Query-Dokumentation.
Häufig gestellte Fragen
Ist Redux inzwischen überflüssig?
Nein. Wandert der Serverzustand in eine Query-Bibliothek, bleibt für Redux weniger zu tun. In Projekten mit komplexen clientseitigen Geschäftsregeln, Bedarf an Time-Travel-Debugging und dem Wunsch nach strenger Struktur in großen Teams ist Redux Toolkit weiterhin eine sinnvolle Wahl.
Wie wählt man zwischen TanStack Query und SWR?
Beide cachen Serverzustand und validieren im Hintergrund neu. SWR bietet eine kleinere API; TanStack Query ist bei Mutationen, Invalidierung, Infinite Queries und DevTools umfassender. In Geschäftsanwendungen mit vielen Mutationen braucht TanStack Query in der Regel weniger manuellen Code.
Verursacht Context Performanceprobleme?
Ändert sich ein Context-Wert, werden alle Komponenten, die ihn lesen, neu gerendert. Bei selten wechselnden Werten wie Theme oder Sprache ist das unproblematisch. Bei häufig wechselnden Werten, die viele Komponenten lesen, teilen Sie den Context auf oder nutzen einen Store mit Selector-Unterstützung.
Warum sollte ich Filter in der URL halten?
Ein Filter in der URL bleibt in einem geteilten Link erhalten, funktioniert korrekt mit den Vor- und Zurück-Tasten des Browsers und geht beim Neuladen der Seite nicht verloren. Ein im Store gehaltener Filter bietet keines dieser Verhalten von selbst.