404-Not-Found-Fehler: Bedeutung und Behebung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Eine Seite zeigt 404, Not Found oder eine benutzerdefinierte Meldung für eine fehlende Seite an, während andere Seiten derselben Website geladen werden.
• Eine API-Anfrage gibt 404 zurück, obwohl Hostname und Server erreichbar sind.
• Eine zuvor funktionierende URL gibt nach einem Deployment, einer Migration, einer Änderung der Permalinks oder einer Anwendungsaktualisierung plötzlich 404 zurück.
• Suchergebnisse, Lesezeichen oder interne Links führen zu Inhalten, die nicht mehr verfügbar sind.
• Nach einer Änderung der Konfiguration von Webserver, Reverse Proxy oder Rewrites schlagen mehrere voneinander unabhängige Pfade fehl.

Hauptursachen nach Wahrscheinlichkeit

Wahrscheinliche Ursachen, von häufigsten bis weniger häufigen:

1. Falsch eingegebene oder unvollständige URL: Ein Schreibfehler, ein fehlendes Pfadsegment oder eine falsche Groß- und Kleinschreibung verweist auf eine nicht vorhandene Ressource.
2. Gelöschte oder verschobene Inhalte: Die Seite oder Datei wurde entfernt, umbenannt oder verschoben, ohne dass eine relevante Weiterleitung eingerichtet wurde.
3. Defekter interner oder externer Link: Ein Link verweist weiterhin auf eine veraltete URL, häufig nach einer Migration oder einer Änderung der URL-Struktur.
4. Fehlende Anwendungsroute: Die bereitgestellte Anwendung definiert die angeforderte Seite oder den API-Endpunkt nicht, oder der Pfad verwendet die falsche API-Version oder das falsche Präfix.
5. Falsche Rewrite- oder Permalink-Regeln: Apache, Nginx, ein Framework-Router oder eine CMS-Konfiguration leitet einen gültigen Pfad nicht an den vorgesehenen Handler weiter.
6. Problem mit Deployment oder Dokumentenstamm: Eine Datei, Route oder ein Build-Ergebnis wurde nicht bereitgestellt, oder der Server liefert ein anderes Verzeichnis aus als erwartet.
7. Abweichung beim Reverse Proxy: Ein Proxy oder Gateway sendet die Anfrage an die falsche Anwendung oder das falsche Backend, wo dieser Pfad unbekannt ist.
8. Unterschied bei der Groß- und Kleinschreibung des Pfads: Eine URL, die in einer Umgebung funktioniert, kann auf einem Dateisystem oder Server mit Beachtung der Groß- und Kleinschreibung fehlschlagen, wenn die Schreibweise nicht mit der Route oder dem Dateinamen übereinstimmt.

So behebst du den Fehler

Wenn Sie die Website besuchen

1. Prüfen Sie die Adresse erneut, einschließlich Schreibweise, Groß- und Kleinschreibung, Bindestrichen, Dateiendungen und jedem einzelnen Pfadsegment.
2. Entfernen Sie ein verdächtiges letztes Pfadsegment oder navigieren Sie von der Startseite der Website aus und verwenden Sie die integrierte Suche, um die aktuelle Seite zu finden.
3. Wenn Sie über ein Lesezeichen oder ein Suchergebnis auf die Seite gelangt sind, suchen Sie nach einer neueren Version des Inhalts, statt dieselbe URL wiederholt zu aktualisieren.
4. Melden Sie einen defekten vertrauenswürdigen Link dem Betreiber der Website. Geben Sie dabei die genaue URL und die Seite an, auf der Sie den Link gefunden haben.

Wenn Sie die Website verwalten

1. Prüfen Sie die fehlschlagende Anfrage. Erfassen Sie den genauen Pfad, die HTTP-Methode, den Host, den Query-String und den Zeitpunkt des Fehlers. Prüfen Sie, ob das Problem eine einzelne URL, eine Routenfamilie oder die gesamte Website betrifft.
2. Entscheiden Sie, ob die Ressource existieren sollte. Prüfen Sie den Inhaltseintrag, bereitgestellte Dateien oder die Definition der Anwendungsroute. Eine absichtlich entfernte Ressource sollte normalerweise 404 bleiben, sofern kein wirklich relevanter Ersatz existiert.
3. Vergleichen Sie einen fehlschlagenden und einen funktionierenden Pfad. Achten Sie auf Unterschiede bei Groß- und Kleinschreibung, abschließenden Schrägstrichen, Dateiendungen, Locales-Präfixen, API-Version, Routenpräfix und Query-Verarbeitung.
4. Prüfen Sie Routing- und Rewrite-Konfiguration. Untersuchen Sie den Anwendungsrouter, CMS-Permalinks, Webserver-Regeln, den Dokumentenstamm und Reverse-Proxy-Zuordnungen. Nehmen Sie Konfigurationsänderungen nur mit entsprechender Berechtigung vor, nachdem Sie die aktuelle Konfiguration gesichert und die Auswirkungen auf andere Routen berücksichtigt haben.
5. Prüfen Sie das Deployment. Stellen Sie sicher, dass die erwartete Datei, das Build-Ergebnis, die Route und statische Assets im bereitgestellten Release enthalten sind und dass der aktive Server das vorgesehene Release verwendet.
6. Prüfen Sie die Logs. Verwenden Sie Webserver-, Proxy- und Anwendungslogs, um festzustellen, welche Komponente den 404 erzeugt hat und ob die Anfrage das erwartete Backend erreicht hat. Entfernen oder anonymisieren Sie Anmeldedaten, Tokens und personenbezogene Daten, bevor Sie Logs weitergeben.
7. Reparieren Sie Links oder Weiterleitungen. Aktualisieren Sie interne Links auf den aktuellen Pfad. Wenn Inhalte dauerhaft verschoben wurden, richten Sie eine autorisierte permanente Weiterleitung auf das nächstliegende gleichwertige Ziel ein. Leiten Sie nicht zusammengehörige fehlende URLs nicht auf die Startseite weiter.
8. Überprüfen Sie die Fehlerantwort. Rufen Sie die ursprüngliche fehlende URL ab und bestätigen Sie, dass sie den HTTP-Status 404 zurückgibt. Eine benutzerdefinierte Fehlerseite kann hilfreich sein, sollte eine fehlende Ressource jedoch nicht in eine irreführende erfolgreiche 200-Antwort umwandeln.
9. Testen Sie betroffene Pfade erneut. Prüfen Sie nach der Änderung die ursprüngliche URL, gegebenenfalls die Ersatz-URL, repräsentative funktionierende Routen und relevante API-Methoden. Überwachen Sie anschließend die 404-Logs auf verbleibende defekte Links.

Vorbeugung und Überprüfung der Lösung

• Führen Sie vor und nach Migrationen, Redesigns und Änderungen der URL-Struktur Prüfungen auf defekte Links durch.
• Dokumentieren Sie Weiterleitungen für wichtige Inhalte, die dauerhaft verschoben werden.
• Testen Sie repräsentative Seiten-, Asset- und API-Routen als Teil jedes Deployments.
• Behandeln Sie Groß- und Kleinschreibung von Pfaden, abschließende Schrägstriche, Locales-Präfixe und API-Versionen als explizite Routing-Entscheidungen.
• Verwalten Sie die Routing-Konfiguration von Webserver, Reverse Proxy und Anwendung über eine kontrollierte Änderungsverwaltung.
• Überwachen Sie häufig angeforderte 404-Pfade, um defekte interne Links, veraltete Integrationen und wiederkehrende Benutzeranfragen zu erkennen.
• Bewahren Sie stabile URLs für Inhalte, die verfügbar bleiben oder indexiert werden sollen.
• Stellen Sie sicher, dass benutzerdefinierte Fehler-Templates den korrekten HTTP-Status beibehalten.

Häufig gestellte Fragen