Lorixen.
DE

Fehler 500 nach Änderung an der .htaccess: Schnell zurück zur funktionierenden Seite

Kurz gesagt: Wenn die Website direkt nach einer Änderung an der .htaccess mit „500 Internal Server Error“ antwortet, ist fast immer diese Datei schuld. Spielen Sie als Erstes die vorherige Version zurück oder benennen Sie die Datei um, dann ist die Seite meist sofort wieder erreichbar. Danach lesen Sie im Fehlerlog des Hosters, welche Zeile Apache nicht verstanden hat: typisch sind Tippfehler, Befehle für ein nicht geladenes Modul oder doppelte, widersprüchliche Regeln. Bei WordPress stellen Sie den Standardblock wieder her. Künftige Änderungen testen Sie auf einer Kopie oder zumindest Zeile für Zeile.

Warum eine einzige Zeile alles lahmlegt

Die .htaccess ist eine Konfigurationsdatei für den Apache-Webserver, die bei jedem Seitenaufruf gelesen wird. Versteht Apache eine Zeile darin nicht, bricht er die Bearbeitung ab und liefert für alle Seiten im betroffenen Verzeichnis und darunter den Fehler 500. Das betrifft nicht nur die geänderte Unterseite, sondern meist die gesamte Website samt Adminbereich. Wie Apache diese Dateien verarbeitet, erklärt die Apache-Anleitung zu .htaccess.

Ein typischer Fall: Ein Steuerberatungsbüro in St. Pölten möchte alte Adressen nach einem Relaunch umleiten. Jemand kopiert dreißig Weiterleitungen aus einer Tabelle in die Datei. In einer Zeile fehlt ein Leerzeichen zwischen Quelle und Ziel. Ergebnis: Die komplette Website ist weg, auch die Startseite.

Schritt 1: Sofort zurück zur funktionierenden Version

Geschwindigkeit geht vor Ursachenforschung. Verbinden Sie sich per FTP, SFTP oder über den Dateimanager im Kundenbereich Ihres Hosters und gehen Sie ins Hauptverzeichnis der Website.

  • Sicherung vorhanden: Laden Sie die zuletzt funktionierende .htaccess hoch und überschreiben Sie die aktuelle. Die fehlerhafte Fassung vorher unter anderem Namen speichern, etwa htaccess-kaputt.txt, damit Sie sie analysieren können.
  • Keine Sicherung: Benennen Sie die Datei in .htaccess-alt um. Die Seite lädt dann ohne die Regeln. Bei WordPress funktionieren Unterseiten mit schönen Adressen vorübergehend nicht, die Startseite und der Login aber meist schon.

Achten Sie darauf, dass Ihr FTP-Programm versteckte Dateien anzeigt. Dateien, deren Name mit Punkt beginnt, sind sonst unsichtbar. In FileZilla lässt sich das über das Menü „Server“ einstellen.

Schritt 2: Das Fehlerlog lesen

Fast jeder Hoster bietet im Kundenbereich Zugriff auf das Fehlerprotokoll des Webservers, manchmal als „Error-Log“, manchmal unter Statistiken oder Logdateien. Suchen Sie nach Einträgen zur Uhrzeit des Fehlers. Typische Meldungen:

Meldung im Log (sinngemäß) Bedeutung
Invalid command, perhaps misspelled or defined by a module not included Tippfehler oder fehlendes Modul
RewriteRule: bad argument line Syntaxfehler in einer Umschreibregel
Request exceeded the limit of 10 internal redirects Endlosschleife durch sich gegenseitig auslösende Regeln
not allowed here Befehl ist in .htaccess vom Hoster nicht erlaubt

Die Meldung nennt meist die Datei und oft den betroffenen Befehl. Damit wissen Sie, welche Zeile Sie sich ansehen müssen.

Die typischen Ursachen

Tippfehler

Ein fehlendes Leerzeichen, ein vergessener Buchstabe in RewriteEngine, ein Anführungszeichen aus einem Textverarbeitungsprogramm, das kein gerades Zeichen ist. Kopieren Sie Regeln nie aus Word oder aus formatierten Webseiten, sondern tippen Sie sie in einem reinen Texteditor oder kopieren Sie sie aus einer Quelle mit Codeformatierung.

Fehlendes Modul

Befehle wie Header, ExpiresActive oder RewriteRule setzen bestimmte Apache-Module voraus. Ist ein Modul auf Ihrem Server nicht aktiv, ist der Befehl unbekannt. Abhilfe schafft eine Umschließung mit <IfModule>, dann wird der Block nur ausgeführt, wenn das Modul vorhanden ist. Oder Sie fragen den Hoster, ob er das Modul freischaltet.

Doppelte oder widersprüchliche Regeln

Nach Jahren voller Plugins und manueller Ergänzungen stehen in mancher Datei zwei Weiterleitungen auf https, eine von einem Sicherheits-Plugin, eine von Hand. Das kann zu Endlosschleifen führen. Räumen Sie auf: Jede Aufgabe genau einmal.

Nicht erlaubte Befehle

Manche Hoster erlauben in der .htaccess keine PHP-Einstellungen per php_value, weil PHP anders angebunden ist. Dann führt genau diese Zeile zum Fehler. Nutzen Sie stattdessen die PHP-Einstellungen im Kundenbereich.

Schritt 3: Den WordPress-Standardblock wiederherstellen

Für WordPress gibt es einen Standardblock, der die schönen Adressen ermöglicht. Er steht zwischen den Kommentaren # BEGIN WordPress und # END WordPress und ist in der WordPress-Dokumentation zum Apache-Server abgedruckt. Für eine einfache Installation im Hauptverzeichnis lautet er:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Legen Sie eine neue, leere .htaccess mit nur diesem Block an und laden Sie sie hoch. Läuft die Seite, ergänzen Sie Ihre eigenen Regeln oberhalb davon. Alternativ öffnen Sie im Dashboard die Permalink-Einstellungen und speichern einmal, dann schreibt WordPress den Block neu, sofern die Datei beschreibbar ist.

Schritt 4: Eigene Regeln einzeln zurückholen

Nehmen Sie die fehlerhafte Fassung und fügen Sie Block für Block in die funktionierende Datei ein, nach jedem Block die Seite testen. So finden Sie die problematische Stelle zuverlässig, auch wenn das Log nichts Eindeutiges nennt. Bei langen Weiterleitungslisten teilen Sie in Hälften: erste Hälfte einfügen, testen, dann die zweite.

Nach der Reparatur: fünf Kontrollen

Lädt die Startseite wieder, ist die Arbeit noch nicht ganz erledigt. Gehen Sie diese Punkte in einem privaten Browserfenster durch, damit kein zwischengespeicherter Stand Sie täuscht:

  1. Unterseiten: eine Leistungsseite und einen Blogbeitrag aufrufen, nicht nur die Startseite.
  2. Verschlüsselung: die Adresse einmal bewusst mit http:// eintippen und prüfen, ob sauber auf https:// umgeleitet wird, ohne Zwischenschritte über mehrere Adressen.
  3. Alte Adressen: drei bis vier Einträge aus der Umleitungsliste des St. Pöltner Büros stichprobenartig testen. In den Entwicklerwerkzeugen des Browsers sehen Sie im Reiter Netzwerk, ob der Statuscode 301 lautet.
  4. Anmeldung: den Adminbereich öffnen und sich einloggen.
  5. Formulare: eine Testanfrage über das Kontaktformular senden.

Ist ein Cache-Plugin oder ein Zwischenspeicher beim Hoster aktiv, leeren Sie diesen vorher, sonst prüfen Sie womöglich noch die alte Auslieferung.

Künftig sicher ändern

  • Vor jeder Änderung eine Kopie mit Datum herunterladen.
  • Änderungen erst auf einer Testkopie der Website ausprobieren, viele Hoster bieten Staging mit einem Klick.
  • Größere Weiterleitungslisten über ein Weiterleitungs-Plugin oder die Serverkonfiguration pflegen statt händisch.
  • Kommentare in die Datei schreiben, wer was wann ergänzt hat.

Häufige Fragen

Mein Hoster nutzt nginx. Gilt das trotzdem?

Nein. nginx liest keine .htaccess. Regeln werden dort in der Serverkonfiguration gesetzt, meist durch den Hoster.

Die Seite lädt wieder, aber Unterseiten zeigen 404. Warum?

Der WordPress-Block fehlt. Stellen Sie ihn wie oben beschrieben wieder her.

Kann ein Plugin die .htaccess kaputt machen?

Ja, Cache-, Sicherheits- und Weiterleitungs-Plugins schreiben hinein. Deaktivieren Sie sie und prüfen Sie, ob ihre Blöcke danach entfernt wurden.

Lässt sich die Ursache des Serverfehlers nicht eingrenzen oder wollen Sie Ihre Weiterleitungen sauber neu aufsetzen, unterstützen wir Sie gern über unser Anfrageformular.

Quellen

WhatsAppTermin buchen