Website lädt ohne CSS: MIME-Typ „text/html“ statt Stildatei
Kurz gesagt: Wenn Ihre Website plötzlich ohne Gestaltung erscheint, also nur schwarzer Text auf weißem Grund, und in der Browser-Konsole eine Meldung wie „Refused to apply style … because its MIME type ('text/html') is not a supported stylesheet MIME type“ steht, liefert der Server statt der CSS-Datei etwas anderes aus. In den allermeisten Fällen ist das eine HTML-Seite, meist die 404-Fehlerseite, weil die Datei unter dieser Adresse nicht existiert. Seltener meldet der Server für eine vorhandene Datei den falschen Typ. Laut MDN blockieren Browser Stil- und Skriptdateien mit unpassendem Typ, wenn der Server den Header X-Content-Type-Options: nosniff sendet. Die Lösung: Adresse der Datei prüfen, Pfade und Build korrigieren, Server-Typen richtig setzen.
Was die Meldung bedeutet
Jede Datei, die ein Server ausliefert, bekommt einen Content-Type, auch MIME-Typ genannt. Laut MDN ist das für Stildateien text/css und für JavaScript text/javascript, für HTML-Seiten text/html.
Erwartet der Browser eine Stildatei und bekommt eine Antwort mit dem Typ text/html, passt das nicht zusammen. Laut MDN blockiert der Browser bei Anfragen für Skripte und Stildateien die Antwort, wenn der MIME-Typ nicht dem erwarteten Typ entspricht und der Server nosniff gesetzt hat. Viele Server und Sicherheits-Plugins setzen diesen Header heute standardmäßig. Bei JavaScript-Modulen prüfen Browser laut MDN den Typ ohnehin streng und führen das Skript bei falschem Typ nicht aus.
Für Besucherinnen sieht das so aus: Die Seite lädt, aber das Layout fehlt, Menüs funktionieren nicht, oder interaktive Elemente reagieren nicht.
Ursache 1: Die Datei existiert unter dieser Adresse nicht
Das ist der häufigste Fall. Der Browser fragt eine Datei an, etwa /assets/style.4f2a.css, und der Server findet sie nicht. Statt einer schlichten Fehlermeldung liefert er eine gestaltete 404-Seite aus, und die ist HTML. Daher die Meldung mit text/html.
Typische Gründe:
- Neuer Build, alte Seite: Nach einem Update haben die Dateien neue Namen mit anderen Prüfsummen, eine zwischengespeicherte HTML-Seite verweist aber noch auf die alten.
- Falscher Pfad nach einem Umzug: Die Website liegt jetzt in einem Unterordner oder auf einer anderen Domain, die Pfade zeigen noch auf die alte Struktur.
- Unvollständiger Upload: Der Ordner mit den Stildateien wurde nicht mit hochgeladen.
- Weiterleitungsregeln: Eine Regel, die alle unbekannten Adressen auf die Startseite umleitet, wie sie bei Single-Page-Anwendungen üblich ist, liefert auch für fehlende CSS-Dateien die Startseite aus.
Ursache 2: Der Server meldet den falschen Typ
Seltener existiert die Datei, aber der Server ordnet ihr den falschen Typ zu. Laut MDN unterscheiden sich die Standardeinstellungen von Servern stark, und ältere Konfigurationen melden für unbekannte Dateien manchmal text/plain oder application/octet-stream. Das passiert eher bei ungewöhnlichen Endungen, etwa .mjs für JavaScript-Module, oder wenn eine Datei über ein Skript statt direkt ausgeliefert wird.
Schritt 1: Die Datei direkt aufrufen
Öffnen Sie die Entwicklerwerkzeuge des Browsers, wechseln Sie in den Reiter Netzwerk und laden Sie die Seite neu. Suchen Sie die betroffene CSS- oder JavaScript-Datei und prüfen Sie:
- Welcher Statuscode kommt zurück? 404 bedeutet, die Datei fehlt.
- Welcher Content-Type steht in den Antwort-Headern?
- Was steht in der Vorschau der Antwort? Sehen Sie HTML Ihrer Fehlerseite statt CSS, ist der Fall klar.
Öffnen Sie die Adresse der Datei zusätzlich direkt in einem neuen Tab.
Schritt 2: Pfade und Build korrigieren
Fehlt die Datei, klären Sie, warum:
- Liegt die Datei auf dem Server, aber unter einem anderen Namen? Dann verweist die HTML-Seite auf einen veralteten Stand. Leeren Sie die Caches von Website, Plugin und CDN und prüfen Sie, ob die Seite nach dem Update neu erzeugt wurde.
- Fehlt die Datei ganz? Dann wurde sie beim Upload oder Deployment nicht übertragen.
- Stimmt der Basis-Pfad? Nach einem Umzug in einen Unterordner müssen Pfade in der Konfiguration des Systems oder des Build-Werkzeugs angepasst werden.
Schritt 3: Weiterleitungsregeln eingrenzen
Wenn Ihre Website alle unbekannten Adressen auf eine Seite umleitet, nehmen Sie Dateien mit Endungen wie .css, .js, .mjs, Bilder und Schriften davon aus. Fehlende Dateien sollten mit einem echten 404 antworten. Das macht Fehler sofort sichtbar, statt sie hinter einer HTML-Seite zu verstecken.
Schritt 4: Server-Typen prüfen
Existiert die Datei und kommt sie mit falschem Typ, ergänzen Sie die Zuordnung in der Serverkonfiguration oder bitten Ihren Hoster darum. Für .css gehört text/css dazu, für .js und .mjs ein JavaScript-Typ wie text/javascript. Schalten Sie nosniff nicht ab, um das Problem zu umgehen. Der Header schützt laut MDN davor, dass Browser den Typ von Antworten erraten.
So beugen Sie vor
- Nach jedem Deployment prüfen: Öffnen Sie die wichtigsten Seiten in einem privaten Browserfenster und werfen Sie einen Blick in die Konsole. Fehlermeldungen zu Stil- und Skriptdateien fallen dort sofort auf.
- Alte Dateien eine Weile behalten: Löschen Sie die Dateien des vorherigen Builds nicht sofort. Zwischengespeicherte Seiten, die noch darauf verweisen, laden dann weiterhin korrekt.
- HTML kürzer zwischenspeichern als Dateien: Stil- und Skriptdateien mit Prüfsummen im Namen dürfen lange im Cache bleiben, HTML-Seiten sollten schneller erneuert werden.
- Überwachung einrichten: Ein einfacher Dienst, der regelmäßig eine Seite abruft und auf fehlende Dateien prüft, meldet das Problem, bevor Kunden es tun.
Ein Beispiel zur Veranschaulichung
Frei erfunden: Ein Tourismusbetrieb aus dem Salzkammergut lässt seine Website von einer Agentur auf einen neuen Build umstellen. Am Tag danach erscheint die Startseite für manche Gäste ohne Gestaltung. In der Konsole steht die MIME-Meldung, im Netzwerk-Reiter liefert die CSS-Datei einen 404 mit der hübsch gestalteten Fehlerseite. Ursache: Das CDN hatte die alte Startseite noch zwischengespeichert, die auf Dateinamen des vorherigen Builds verweist. Nach dem Leeren des CDN-Caches und einer Regel, die HTML künftig kürzer zwischenspeichert, lädt die Seite wieder korrekt.
Häufige Fragen
Liegt der Fehler beim Browser der Besucher?
In der Regel nicht. Der Browser verhält sich korrekt, wenn er eine HTML-Antwort nicht als Stildatei verwendet. Die Ursache liegt bei Server, Pfaden oder Caches.
Soll ich den Header nosniff entfernen?
Nein. Er schützt vor falsch interpretierten Antworten. Beheben Sie stattdessen Pfade und Typen.
Betrifft das auch Schriften und Bilder?
Ähnlich, aber mit anderen Meldungen. Fehlende Schriftdateien oder Bilder führen ebenfalls oft zu einer HTML-Fehlerseite statt der Datei. Der Netzwerk-Reiter zeigt das auf die gleiche Weise.
Warum betrifft es nur manche Besucher?
Oft sehen nur Besucher mit einer zwischengespeicherten alten Seite den Fehler, während andere schon die neue Fassung erhalten.
Wenn Ihre Website nach einem Update ohne Gestaltung lädt, finden wir die fehlenden Dateien gerne gemeinsam: Darstellungsfehler melden.