Ein fehlendes öffentliches Dokument sollte eine klare Erklärung anzeigen und einen passenden HTTP-Status zurückgeben, in der Regel 404. Auf einem Mac kannst du beides in Chrome überprüfen, die Abweichung erkennen und deinem Veröffentlichungssystem eine präzise Korrekturanweisung geben.

Dieser Arbeitsablauf richtet sich an Personen, die Seiten mit öffentlichen Dokumenten pflegen: Anleitungen, Referenznotizen oder einfache Merkblätter. Ziel ist, dass die angeforderte Adresse, die Serverantwort und die angezeigte Meldung übereinstimmen. Alle unten aufgeführten Beispielpfade sind fiktiv.

Welchen Status sollte ein fehlendes Dokument zurückgeben?

Lege zuerst fest, was unter der Dokumentadresse geschehen soll. Eine Seite, die verschoben wurde, erfordert eine andere Behandlung als eine Seite, die nicht mehr existiert. Verwende diese Entscheidungstabelle, bevor du das Design der Fehlerseite änderst.

Zustand des Dokuments Vorgesehene Antwort Anzeige für Leserinnen und Leser
Es ist unter der angeforderten Adresse vorhanden 200 OK Das vollständige Dokument
Es gibt einen eindeutigen dauerhaften Ersatz Weiterleitung 301 Das Ersatzdokument unter seiner neuen Adresse
Es kann nicht gefunden werden und es gibt keinen gleichwertigen Ersatz 404 Not Found Eine hilfreiche Erklärung, dass das Dokument fehlt
Es wurde absichtlich entfernt und wird wahrscheinlich dauerhaft fehlen 410 Gone ist angemessen Eine klare Erklärung der Entfernung und hilfreiche Navigation

HTTP definiert 404, ohne anzugeben, ob das Fehlen vorübergehend oder dauerhaft ist. 410 ist für eine Ressource vorgesehen, deren Nichtverfügbarkeit wahrscheinlich dauerhaft ist; wenn die Dauerhaftigkeit unbekannt ist, verwende 404. Diese Bedeutungen sind in RFC 9110, Abschnitte 15.5.5 und 15.5.11 beschrieben.

Google empfiehlt eine dauerhafte Weiterleitung, wenn ein Dokument verschoben wurde oder es einen eindeutigen Ersatz gibt. Wurde es ohne einen ähnlichen Ersatz entfernt, empfiehlt Google 404 oder 410. Siehe Googles Anleitung zum Umgang mit Antworten für fehlende Inhalte.

Angenommen, /documents/paper-folding-notes wurde durch /documents/paper-folding-guide ersetzt und enthält im Wesentlichen gleichwertige Anleitungen. Dann ist eine dauerhafte Weiterleitung passend. Wurden die Notizen ohne Ersatz entfernt, sollte unter der alten Adresse weiterhin eine Antwort für ein fehlendes Dokument zurückgegeben werden. Auf dieser Seite kann ein Link zu einem allgemeinen Dokumentverzeichnis angeboten werden.

Warum ein überzeugend gestalteter Hinweis auf eine fehlende Seite nicht genügt

Eine Seite kann deutlich Document not found anzeigen, während der Server 200 zurückgibt. Google bezeichnet diese Art von Abweichung als Soft-404. Auch eine leere Seite oder eine Seite ohne Hauptinhalt kann so eingestuft werden. Lies Googles Erklärung zu Soft-404-Fehlern.

Der Status gehört zur HTTP-Antwort und ist vom Erklärungstext getrennt. Daher lässt sich der Antwortcode nicht durch eine geänderte Überschrift oder eine große Kennzeichnung mit 404 festlegen. Prüfe die tatsächliche Dokumentanfrage, bevor du entscheidest, dass das Problem behoben ist. RFC 9110 beschreibt die Funktion von Antwortstatuscodes.

Wie überprüfst du die Dokumentantwort auf einem Mac?

Verwende für diese Prüfung die integrierten Chrome-Tools. Halte die Adresse eines bekannten funktionierenden Dokuments und einen absichtlich nicht vorhandenen Pfad auf derselben öffentlichen Website bereit. Der fehlende Pfad könnte beispielsweise /documents/missing-paper-example-731 lauten. Wähle eine Adresse, von der du weißt, dass dort kein Dokument veröffentlicht wurde.

  1. Öffne die öffentliche Seite in Chrome.
  2. Drücke Command + Option + I, um die DevTools zu öffnen.
  3. Wähle den Bereich Network aus.
  4. Gib bei geöffneten DevTools die Testadresse in die Adressleiste ein und lade sie.

Chrome dokumentiert die Mac-Tastenkombination unter Chrome DevTools öffnen. Netzwerkaktivitäten werden aufgezeichnet, solange die DevTools geöffnet sind, wie in der Übersicht zum Bereich „Network“ erläutert.

  1. Wähle Disable cache, damit du dich bei dieser Prüfung nicht auf eine im Browser zwischengespeicherte Antwort verlässt.
  2. Aktiviere Preserve log, wenn du Weiterleitungen verfolgen musst.
  3. Lade die Testadresse neu.
  4. Wähle die zugehörige Hauptdokumentanfrage aus und öffne dann Headers. Lies unter General die angeforderte Adresse und den Statuscode ab.

Diese Steuerelemente und die Position der Statusinformationen sind in Chromes Referenz zu den Netzwerkfunktionen dokumentiert.

Prüfe die Dokumentanfrage sorgfältig. Das Protokoll enthält auch Anfragen für Skripte, Stylesheets und andere Ressourcen. Eine fehlende unterstützende Datei belegt nicht, dass das Dokument selbst 404 zurückgegeben hat. In Chromes Anfragentabelle unterscheidet Status den HTTP-Code und Type die Ressourcenart; siehe Netzwerkaktivitäten untersuchen.

Vergleiche nun drei Beobachtungen: die ursprünglich angeforderte Adresse, den Antwortcode für dieses Dokument und die nach dem Laden sichtbare Seite. Halte sie gemeinsam fest. Ändert sich die Adresse durch die Navigation, prüfe die ursprüngliche Anfrage und das Ziel, statt nur die endgültige Seite zu notieren.

Wie leitest du aus den Beobachtungen eine Korrektur ab?

Die folgende Diagnosetabelle ist eine praktische Zusammenfassung der HTTP-Bedeutungen und der Google-Hinweise zur Fehlerbehebung. Sie dient als Entscheidungshilfe und enthält keine gemessenen Ergebnisse.

Beobachtetes Ergebnis Was zu untersuchen ist Vorgesehene Korrektur
200 mit einem Hinweis auf ein fehlendes Dokument Handler oder Fallback für fehlende Pfade 404 zusammen mit der Erklärung zurückgeben
404 und das erwartete Dokument wird angezeigt Die für eine vorhandene Route festgelegte Antwort Das Dokument mit 200 erfolgreich ausliefern
Weiterleitung zu einem allgemeinen Verzeichnis Ob es einen gleichwertigen Ersatz gibt Zum gleichwertigen Dokument weiterleiten oder eine Fehlerseite anzeigen
200 mit einem leeren oder unvollständigen Dokument Laden und Rendern der Inhalte Den vorgesehenen Inhalt wiederherstellen, falls das Dokument noch existiert
404 mit einem hilfreichen Hinweis auf die fehlende Seite Ob die Adresse tatsächlich nicht vorhanden ist Dieses Verhalten beibehalten, wenn das Fehlen beabsichtigt ist

Googles Dokumentation zur Fehlerbehebung unterscheidet ausdrücklich zwischen nicht verfügbaren Dokumenten, verschobenen Dokumenten und noch vorhandenen Dokumenten, die nicht korrekt geladen werden. Diese Unterscheidung verhindert, dass eine unvollständige, aber funktionierende Seite als absichtlich entfernt behandelt wird. Siehe Fehler beim Crawling durch die Google-Suche beheben.

Für eine konkrete Übergabe kannst du schreiben: „Gib für den fiktiven fehlenden Pfad /documents/missing-paper-example-731 404 zurück und zeige an dieser Adresse die benutzerdefinierte Seite für fehlende Dokumente an. Bestehende Dokumentpfade müssen weiterhin funktionieren. Verwende dauerhafte Weiterleitungen nur, wenn ein gleichwertiger Ersatz ermittelt wurde.“ Ergänze den beobachteten Status und die sichtbare Meldung aus deiner Prüfung.

Diese Anforderung beschreibt das gewünschte Verhalten, ohne Menünamen deines Veröffentlichungssystems zu erraten. Die Umsetzung gehört in die Hosting-Konfiguration, die Anwendungsroute oder das Veröffentlichungssystem, das die Antwort erzeugt. Google erklärt in seiner Dokumentation zu HTTP-Statuscodes, dass HTTP-Statuscodes vom Hostingserver erzeugt werden.

Was, wenn du im Editor nur den Seiteninhalt ändern kannst?

Ein Editor, mit dem sich Text oder Dokumentmetadaten ändern lassen, kann HTTP-Antworten möglicherweise nicht steuern. Der WHATWG-HTML-Standard definiert bestimmte Verhaltensweisen für meta-Direktiven mit http-equiv; das Festlegen eines HTTP-Antwortstatus gehört nicht dazu. http-equiv="status" hinzuzufügen ist daher keine unterstützte Methode, um einen 404 zu erzeugen. Siehe HTML-Standard: Pragma-Direktiven.

Wenn sich die Antwort im Editor nicht steuern lässt, verwende den dokumentierten Mechanismus für fehlende Seiten in der Hosting- oder Anwendungsebene. Frage nach, ob der benutzerdefinierte Inhalt unter der angeforderten fehlenden Adresse mit 404 ausgeliefert wird. Eine Einstellung, die lediglich das Layout einer Fehlerseite auswählt, beantwortet diese Frage nicht. Überprüfe das Ergebnis mit dem beschriebenen Ablauf im Browser.

Ein dokumentiertes Beispiel für statische Seiten auf Netlify

Für eine bestehende statische Website auf Netlify ist der dokumentierte Mechanismus eine Datei namens 404.html. Netlify verwendet sie automatisch für fehlgeschlagene Pfade, die keiner statischen Datei entsprechen. Dies ist ein anbieterspezifisches Beispiel mit Voraussetzungen: Zugriff auf die fertig erstellten Website-Dateien und ein vorhandener Build für statische Seiten. Netlify beschreibt die Behandlung benutzerdefinierter 404-Seiten.

  1. Erstelle die Seite für fehlende Dokumente anhand der vorhandenen Seitenvorlage der Website.
  2. Stelle sicher, dass die fertige Ausgabe 404.html im Stammverzeichnis des Veröffentlichungsverzeichnisses enthält.
  3. Prüfe, ob eine frühere Routingregel unbekannte Adressen auf eine andere Seite umleitet.
  4. Nachdem die überarbeitete Ausgabe unter der öffentlichen Adresse verfügbar ist, prüfe einen fehlenden Pfad und ein funktionierendes Dokument.

Die Routingprüfung ist wichtig, weil Netlify die Routingregeln verarbeitet, bevor es zur Behandlung statischer Dateien und zur abschließenden Behandlung fehlender Seiten kommt. Eine Anfrage, die bereits früher abgefangen wurde, erreicht diesen letzten Handler nicht. Die Dokumentation zur Request Chain erläutert die Reihenfolge. Dieses Beispiel beschreibt einen möglichen Korrekturweg und bedeutet nicht, dass eine Website geändert wurde.

Die Grenzen von clientseitig gerouteten Anwendungen

Manche Anwendungen erkennen erst nach dem Ausführen von JavaScript, dass ein Dokument fehlt. Google räumt ein, dass aussagekräftige Statuscodes beim clientseitigen Routing schwierig umzusetzen sein können. Als dokumentierte Alternativen nennt Google eine JavaScript-Weiterleitung zu einer Adresse, deren Server 404 zurückgibt, oder das Hinzufügen von noindex-Metadaten zur Fehlerseite. Siehe Googles SEO-Leitfaden für JavaScript.

Diese Alternativen führen zu unterschiedlichen Ergebnissen. Bei der Weiterleitung wird eine neue Adresse aufgerufen, die eine echte Antwort für eine fehlende Seite zurückgibt. Die Metadatenlösung betrifft die Indexierung, während der ursprüngliche HTTP-Status unverändert bleibt. Wenn die ursprüngliche Dokumentadresse beibehalten und dort 404 zurückgegeben werden soll, muss die Hosting- oder Anwendungsebene dieses Verhalten unterstützen.

Was sollte auf der Seite für fehlende Dokumente stehen?

Verwende eine kurze, konkrete Meldung wie Dieses Dokument wurde nicht gefunden. Ergänze sie um eine sinnvolle nächste Aktion: einen Link zum Dokumentverzeichnis oder zu einem anderen geprüften Navigationsziel. Behalte die vertraute Navigation und das Erscheinungsbild der Website bei. Google empfiehlt für benutzerdefinierte Fehlerseiten eine klare Sprache, ein einheitliches Design und hilfreiche Links.

Für das fiktive Beispiel mit dem Papierfalten wären etwa folgende Texte geeignet: Wir konnten dieses Dokument zum Papierfalten nicht finden. Öffne das Dokumentverzeichnis, um eine andere Anleitung auszuwählen. Behaupte nur dann, ein Dokument sei dauerhaft entfernt worden, wenn das bekannt ist. Lass die Erklärung sichtbar, statt jede fehlende Adresse sofort an eine andere Stelle weiterzuleiten.

Wie überprüfst du, ob Antwort und Seite übereinstimmen?

Wiederhole die Prüfung mit einer kleinen Vergleichsgruppe. Die erwarteten Ergebnisse unten sind beispielhafte Abnahmekriterien und keine gemeldeten Testergebnisse.

Testfall Erwartete Antwort und Seite
Bekanntes, funktionierendes Dokument 200 mit dem vollständigen Dokument
Absichtlich nicht vorhandener Pfad 404 mit der Erklärung, dass das Dokument fehlt
Entferntes Dokument ohne Ersatz 404 oder, falls angemessen, 410 mit einer zutreffenden Erklärung
Verschobenes Dokument mit gleichwertigem Ersatz Dauerhafte Weiterleitung, gefolgt von der erfolgreichen Antwort des Ersatzdokuments

Rufe jede Adresse erneut direkt auf und lade sie neu. Beziehe auch Dokumente ein, die normalerweise über die Navigation innerhalb einer Seite erreicht werden. So prüfst du, welche Antwort eine neue Dokumentanfrage erhält. Halte Adresse, Code und sichtbares Ergebnis zusammen fest, damit ein erfolgreiches Ziel keine fehlerhafte Antwort weiter vorne im Navigationsablauf verdeckt.

Bleibt ein altes Ergebnis bestehen, unterscheide zwischen dem Browsercache und anderen Caches. Durch das Deaktivieren des Chrome-Caches wird der Browsercache umgangen. HTTP-Caches können auch negative Antworten wie 404 speichern. Daher kann es nötig sein, das dokumentierte Cacheverhalten des Veröffentlichungssystems zu prüfen, wenn eine veraltete Fehlantwort angezeigt wird. RFC 9111 erläutert negative, zwischenspeicherbare Ergebnisse.

Für die Google-Suche hat eine echte Fehlerantwort eine beabsichtigte Folge: Google indexiert keine URLs, die 404 oder 410 zurückgeben. Bereits indexierte URLs werden entfernt, sobald Google diese Antworten verarbeitet. Auch eine erfolgreiche Antwort mit 200 garantiert keine Indexierung. Siehe Wie HTTP-Statuscodes die Google-Crawler beeinflussen.

Schließe die Prüfung ab, wenn jede getestete Adresse ein stimmiges Bild ergibt: Verfügbare Dokumente werden erfolgreich geladen, verschobene Dokumente führen zu ihrem Ersatz, und fehlende Dokumente geben eine passende Fehlerantwort mit hilfreicher Navigation zurück. So erhältst du eine konkrete, wiederholbare Prüfung des Veröffentlichungssystems auf deinem Mac.

Quellen