Ergebnis dieses Guides
Eine URL-Tabelle mit Erfolgs- und Fehlerfällen
Arbeitsumgebung
App Router, React und die im Projekt festgehaltene Next.js-Version
Wann ist diese Entscheidung wichtig?
URLs sind eine öffentliche Schnittstelle. Ein Link muss auch nach Neuladen, Weitergabe und direktem Aufruf dieselbe Information liefern.
Ordnen Sie die betroffene Route ihrer page-, layout- oder route-Datei zu. Markieren Sie die Grenze zu Client Components ausdrücklich; Schreibzugriffe und vertrauliche Konfiguration bleiben auf dem Server.
Routing: Schritt für Schritt.
- 01
Vorbereiten
Listen Sie statische Seiten, Parameter, Weiterleitungen und ungültige Werte auf. Legen Sie für jeden Parameter eine erlaubte Datenquelle fest.
- 02
In Next.js umsetzen
Ordnen Sie jede URL einer Route und einem Datensatz zu. Nicht vorhandene Datensätze erhalten 404; dauerhaft umgezogene Inhalte eine passende Weiterleitung.
- 03
Im tatsächlichen Projekt prüfen
Prüfen Sie neben dem Entwicklungsserver einen Produktionsbuild und einen direkten Routenaufruf. Cache-Verhalten und dynamische APIs müssen zur installierten Version passen.
Beispiel zur Überprüfung
So lässt sich das Ergebnis prüfen.
Als Projektkontext dient eine Website mit Leistungsseiten und einem Anfrageformular. Der folgende Prüffall ist eine Vorlage für diese Aufgabe und kein Bericht über eine Kundenmessung.
- Eingabe / Auslöser
- GET /leistungen/webdesign sowie ein direkter Neuaufruf derselben URL
- Erwartetes Ergebnis
- Beide Wege zeigen denselben Inhalt; der Canonical verweist auf die endgültige öffentliche Adresse.
- Fehler- oder Grenzfall
- Ein unbekannter Slug antwortet mit 404 und nicht mit einer generischen Erfolgsseite.
Dateistruktur · begrenztes Beispiel
app/
leistungen/
[slug]/
page.tsx
not-found.tsxDie dynamische Route benötigt zusätzlich eine Prüfung, ob der angefragte Slug in der Datenquelle existiert. Das Vorhandensein des Ordners allein macht beliebige Slugs nicht zu gültigen Inhalten.
Abnahme und typische Fehler.
- Direkte Aufrufe, interne Links und Fehlerseiten funktionieren.
- Ein unbekannter Slug antwortet mit 404 und nicht mit einer generischen Erfolgsseite.
- Client- und Servercode brauchen eine klare Grenze; vertrauliche Daten gehören auf den Server.
Typischer Fehler
Dynamische Routen ohne geprüfte Daten erzeugen leere oder doppelte Seiten.
Quellen und Versionshinweis
Die Anleitung beschreibt das Vorgehen; konkrete APIs, Produktfunktionen und Laufzeitgrenzen müssen zur eingesetzten Version passen. Halten Sie Version, Konfiguration und Prüfergebnis im Projekt fest und vergleichen Sie die verlinkte Dokumentation bei Änderungen.
