500 Error nach .htaccess-Änderung: So reparieren Sie Ihre Website

Die .htaccess ist eine Konfigurationsdatei für den Apache-Webserver. Das Besondere: Der Server liest diese Datei bei jedem einzelnen Seitenaufruf. Enthält sie auch nur einen kleinen Fehler, kann der Server die Anfrage nicht verarbeiten und antwortet mit einem 500 Internal Server Error. Im Gegensatz zu einem 404-Fehler (Seite nicht gefunden) oder einem 403-Fehler (Zugriff verweigert) bedeutet der 500 Error, dass der Server selbst an einer fehlerhaften Konfiguration scheitert.

Das passiert häufiger, als Sie denken. Typische Situationen, in denen die .htaccess zum Problem wird:

• Redirect-Regel eingerichtet: Sie wollten eine Weiterleitung einrichten und haben dabei einen Syntaxfehler eingebaut.
• Code aus dem Internet kopiert: Eine Anleitung aus einem Forum befolgt, aber der Code passt nicht zu Ihrer Server-Konfiguration.
• Passwortschutz aktiviert: Die Pfadangabe zum Passwort-File stimmt nicht oder die Direktive ist falsch geschrieben.
• Plugin hat die Datei verändert: Ein Sicherheits- oder Caching-Plugin hat automatisch Regeln eingefügt, die Ihr Server nicht unterstützt.

Nicht jeder htaccess-Fehler ist gleich. In meiner Arbeit begegnen mir diese fünf Probleme immer wieder, wenn ein 500 Error nach einer .htaccess-Bearbeitung auftritt:

• Syntaxfehler: Tippfehler in Direktiven wie RewriteRul statt RewriteRule, fehlendes Leerzeichen zwischen Parametern oder vergessene Anführungszeichen. Schon ein einziges falsches Zeichen reicht.
• Falsches Dateiformat: Die .htaccess wurde mit Word oder einem Textverarbeitungsprogramm gespeichert, das unsichtbare BOM-Zeichen (Byte Order Mark) einfügt. Die Datei muss im reinen ASCII- oder UTF-8-Format ohne BOM vorliegen.
• Nicht unterstützte Direktiven: Befehle wie php_flag oder php_value funktionieren nur bei Apache mit mod_php. Bei FastCGI- oder PHP-FPM-Konfigurationen (die heute Standard sind) lösen sie sofort einen htaccess Internal Server Error aus.
• Falsche Pfadangaben: Bei AuthUserFile muss der absolute Serverpfad angegeben werden, nicht der relative. Auch eine falsche RewriteBase führt zu Problemen.
• Redirect-Endlosschleifen: Zwei Regeln, die sich gegenseitig weiterleiten, erzeugen eine Endlosschleife. Der Server erkennt das und bricht mit einem 500 Error ab.

Wenn Ihre Website nach einer .htaccess-Änderung nicht mehr funktioniert, gehen Sie systematisch vor. Mit diesen drei Schritten finden und beheben Sie den Syntaxfehler in den meisten Fällen innerhalb weniger Minuten:

Schritt 1: .htaccess per FTP umbenennen

Verbinden Sie sich per FTP mit Ihrem Server und navigieren Sie zum Hauptverzeichnis Ihrer Website. Benennen Sie die Datei .htaccess in .htaccess_backup um. Rufen Sie danach Ihre Website auf. Lädt sie wieder? Dann liegt der Fehler definitiv in der .htaccess-Datei. Zeigt sie weiterhin einen Fehler, ist die Ursache woanders, und Sie sollten im umfassenden Ratgeber zum 500 Error die weiteren Möglichkeiten prüfen.

Schritt 2: Fehlerhafte Zeile finden

Erstellen Sie eine neue, leere .htaccess-Datei und fügen Sie die Zeilen aus Ihrem Backup einzeln oder blockweise wieder ein. Testen Sie nach jeder Ergänzung, ob die Website noch funktioniert. Alternativ können Sie in der Backup-Datei einzelne Zeilen mit einem #-Zeichen auskommentieren und die Website jeweils neu laden. So isolieren Sie die fehlerhafte Direktive.

Schritt 3: Error-Log prüfen und Fehler korrigieren

Prüfen Sie das Error-Log Ihres Servers. Dort finden Sie die exakte Fehlermeldung mit der Zeilennummer, die das Problem verursacht. In meinem Artikel WordPress Error-Logs finden und verstehen erkläre ich Ihnen, wo Sie diese Logdateien finden und wie Sie die Einträge lesen. Korrigieren Sie die fehlerhafte Direktive oder entfernen Sie sie.

Wenn Sie eine WordPress-Website betreiben, generiert WordPress einen eigenen Block in der .htaccess-Datei. Dieser Standard-Code sieht so aus:

# 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

Wichtig: Wenn Sie eigene Regeln hinzufügen (Redirects, Sicherheitseinstellungen, Caching-Regeln), platzieren Sie diese immer vor dem Block # BEGIN WordPress. Regeln, die nach # END WordPress stehen, werden von WordPress beim nächsten Permalink-Speichern möglicherweise überschrieben.

Achten Sie auch darauf, welche Plugins Ihre .htaccess verändern. Sicherheits-Plugins, Caching-Plugins und Redirect-Plugins schreiben häufig eigene Regeln in die Datei. Wenn Sie nach der Aktivierung eines solchen Plugins einen 500 Error erhalten, deaktivieren Sie das Plugin per FTP (benennen Sie den Plugin-Ordner um) und prüfen Sie die .htaccess. In meinem Artikel über die weiße Seite nach Plugin-Updates finden Sie weitere Tipps zur Plugin-Fehlersuche.

Mit ein paar einfachen Gewohnheiten verhindern Sie, dass eine Änderung an der Konfigurationsdatei Ihre Website erneut lahmlegt:

• Backup vor jeder Änderung: Laden Sie die aktuelle Datei herunter, bevor Sie etwas ändern. Im Ernstfall sind Sie in 30 Sekunden wieder online.
• Richtigen Texteditor verwenden: Nutzen Sie Notepad++, VS Code oder einen anderen Code-Editor. Verwenden Sie niemals Word, LibreOffice Writer oder andere Textverarbeitungsprogramme, die unsichtbare Formatierungen einfügen.
• Änderungen einzeln vornehmen: Fügen Sie neue Regeln nacheinander ein und testen Sie nach jeder Ergänzung. So finden Sie Fehler sofort, statt in einem Block aus 20 neuen Zeilen suchen zu müssen.
• Error-Log nach jeder Änderung prüfen: Das Error-Log verrät Ihnen sofort, ob eine Direktive Probleme verursacht, auch wenn die Seite noch funktioniert.
• PHP-Version aktuell halten: Nutzen Sie PHP 8.4 oder neuer. Veraltete PHP-Versionen sind nicht nur langsamer, sondern auch ein Sicherheitsrisiko. Prüfen Sie die Version in Ihrem Hosting-Panel.
• Bei Unsicherheit: Profi fragen: Wenn Sie sich bei einer Konfiguration nicht sicher sind, lassen Sie sich beraten, bevor Sie experimentieren.