Behandlung von Fehlern vom Typ „404“
In diesem Leitfaden findest du häufige Gründe dafür, warum beim Erstellen deiner GitHub Pages-Website möglicherweise ein Fehler vom Typ „404“ angezeigt wird.
- GitHub's Status page
- DNS-Einrichtung
- Browser-Cache
- Datei
- Verzeichnisinhalte
- Benutzerdefinierte Domain
- Repository
GitHub-Statusseite
Wenn beim Erstellen einer GitHub Pages-Website der Fehler „404“ angezeigt wird, überprüfe zuerst die Statusseite von GitHub auf aktive Vorfälle.
DNS-Einrichtung
Stelle sicher, dass die DNS-Einträge von GitHub ordnungsgemäß beim DNS-Anbieter eingerichtet wurden. Weitere Informationen findest du unter AUTOTITLE.
Browser-Cache
Wenn deine GitHub Pages-Website privat ist und der Fehler „404“ angezeigt wird, musst du u. U. den Cache deines Browsers löschen. Informationen zum Löschen deines Caches findest du in der Dokumentation deines Browsers.
-Datei
GitHub Pages sucht nach einer Datei als Eintragsdatei für deine Website.
-
Vergewissere dich, dass im Repository für deine Website auf GitHub eine Datei vorhanden ist. Weitere Informationen finden Sie unter AUTOTITLE.
-
Die Eingabedatei muss sich auf der obersten Ebene der ausgewählten Veröffentlichungsquelle befinden. Wenn deine Veröffentlichungsquelle beispielsweise das Verzeichnis im Branch ist, muss sich deine Eintragsdatei im Verzeichnis in einem Branch namens befinden.
Wenn Ihre Veröffentlichungsquelle ein Zweig und ein Ordner ist, muss sich die Eintragsdatei auf oberster Ebene des Quellordners im Quellzweig befinden. Wenn deine Veröffentlichungsquelle beispielsweise das Verzeichnis im Branch ist, muss sich deine Eintragsdatei im Verzeichnis in einem Branch namens befinden.
Wenn deine Veröffentlichungsquelle ein GitHub Actions-Workflow ist, muss das von dir bereitgestellte Artefakt die Eintragsdatei auf oberster Ebene des Artefakts enthalten. Anstatt die Eintragsdatei Ihrem Repository hinzuzufügen, können Sie Ihren GitHub Actions-Workflow Ihre Eintragsdatei generieren lassen, wenn der Workflow ausgeführt wird.
-
Beim Namen der Datei muss die Groß-/Kleinschreibung beachtet werden. funktioniert beispielsweise nicht.
-
Der Name der Datei muss sein und nicht oder eine andere Variante.
Verzeichnisinhalt
Überprüfe, ob sich dein Verzeichnisinhalt im Stammverzeichnis befindet.
Benutzerdefinierte Domäne
Stelle bei Verwendung einer benutzerdefinierten Domäne sicher, dass sie ordnungsgemäß eingerichtet ist. Weitere Informationen finden Sie unter AUTOTITLE.
- Der -Eintrag sollte immer auf oder verweisen, ohne den Repositorynamen. Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters.
- Wenn du auf deine Landingpage zugreifen kannst, aber auf der gesamten Seite auf fehlerhafte Links stößt, liegt dies wahrscheinlich daran, dass du entweder zuvor keinen benutzerdefinierten Domänennamen hattest oder von einem benutzerdefinierten Domänennamen zurückwechselst. In solchen Fällen wird durch das Ändern des Routingpfads keine Neuerstellung der Seite initiiert. Die empfohlene Lösung besteht darin, sicherzustellen, dass deine Website automatisch neu erstellt wird, wenn du den Namen einer benutzerdefinierten Domäne hinzufügst oder entfernst. Dies kann das Konfigurieren eines Commit-Autors und das Ändern der Einstellungen für die Namen benutzerdefinierter Domänen umfassen.
Repository
Überprüfe, ob dein Repository die folgenden Anforderungen erfüllt:
- Der Branch, den du zum Veröffentlichen deiner Website verwendest, muss der Haupt- oder Standardbranch sein.
- In das Repository muss von einer Person mit Administratorberechtigungen für das Repository (etwa dem Repositorybesitzer oder der Repositorybesitzerin) ein Commit gepusht werden.
- Wenn du die Sichtbarkeit des Repositorys von öffentlich in privat oder umgekehrt änderst, ändert sich die URL deiner GitHub Pages-Website. Dies führt zu fehlerhaften Links, bis die Website neu erstellt wird.
- Wenn du ein privates Repository für die GitHub Pages-Website verwendest, überprüfe, ob dein Abonnement für GitHub Pro, GitHub Team oder GitHub Enterprise Cloud noch aktiv ist. Wenn Sie den Plan verlängern, wird die GitHub Pages-Site automatisch wieder bereitgestellt. Alternativ kannst du die Sichtbarkeit deines Repositorys auf öffentlich setzen, um GitHub Pages weiterhin kostenlos nutzen zu können.
Wenn du weiterhin einen Fehler vom Typ „404“ erhältst, starte eine GitHub Community-Diskussion in der Kategorie „Seiten“.