Fehlerbehebung bei Fehlern vom Typ „404“ für GitHub Pages-Websites

Dieser Leitfaden unterstützt dich bei der Behandlung allgemeiner Ursachen für mögliche 404-Fehler.

Wer kann dieses Feature verwenden?

GitHub Pages ist in öffentlichen Repositorys mit GitHub Free und GitHub Free für Organisationen sowie in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud und GitHub Enterprise Server verfügbar. Weitere Informationen findest du unter GitHub-Pläne.

Alle GitHub Pages Builds verwenden GitHub Actions ab dem 30. Juni 2024. Es sind keine weiteren Änderungen erforderlich, aber GitHub Actions müssen in Ihrem Repository aktiviert sein, damit die Builds fortgesetzt werden können. Weitere Informationen zur Aktivierung von GitHub Actions finden Sie unter „Verwalten von GitHub Actions-Einstellungen für ein Repository“

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.

Statusseite von GitHub

Wenn beim Erstellen einer GitHub Pages-Website der Fehler „404“ angezeigt wird, überprüfe zuerst die Statusseite von GitHub auf aktive Vorfälle.

DNS-Setup

Stelle sicher, dass die DNS-Einträge von GitHub ordnungsgemäß beim DNS-Anbieter eingerichtet wurden. Weitere Informationen findest du unter Eine benutzerdefinierte Domain für deine GitHub Pages-Website verwalten.

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.

index.html-Datei

GitHub Pages sucht nach der Datei index.html als Eintragsdatei für deine Website.

  • Stelle sicher, dass im Repository für deine Website auf GitHub eine Datei vom Typ index.html vorhanden ist. Weitere Informationen finden Sie unter unter „Erstellen einer GitHub Pages-Website“.

  • Die Eingabedatei muss sich auf der obersten Ebene der ausgewählten Veröffentlichungsquelle befinden. Wenn deine Veröffentlichungsquelle beispielsweise das Verzeichnis /docs im Branch main ist, muss sich deine Eintragsdatei im Verzeichnis /docs in einem Branch namens main befinden.

    Wenn deine Veröffentlichungsquelle ein Branch und ein Verzeichnis ist, muss sich die Eintragsdatei auf oberster Ebene des Quellverzeichnisses im Quellbranch befinden. Wenn deine Veröffentlichungsquelle beispielsweise das Verzeichnis /docs im Branch main ist, muss sich deine Eintragsdatei im Verzeichnis /docs in einem Branch namens main 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 index.html muss die Groß-/Kleinschreibung beachtet werden. Index.html funktioniert beispielsweise nicht.

  • Der Name der Datei muss index.html sein und nicht index.HTML 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 unter „Informationen zu benutzerdefinierten Domains und GitHub Pages“.

  • Der CNAME-Eintrag sollte immer auf <USER>.github.io oder <ORGANIZATION>.github.io verweisen, ohne den Repositorynamen. Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters.
  • Wenn du auf deine Angebotsseite zugreifen kannst, die gesamte Seite aber fehlerhafte Links enthält, liegt dies wahrscheinlich daran, dass du entweder zuvor keinen benutzerdefinierten Domänennamen hattest oder einen benutzerdefinierten Domänennamen hattest, jetzt aber nicht mehr. 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 main-Branch 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 weiterhin einen Fehler vom Typ „404“ erhältst, starte eine GitHub Community-Diskussion in der Kategorie „Seiten“.