Leitfaden zur Fehlerbehebung in Joomla

 Wenn deine erste Massnahme bei einem Fehler darin besteht, alles zu aktualisieren, dann behebst du keine Fehler – du spielst ein Glücksspiel.

Drucke diesen Leitfaden aus, bevor du etwas anfasst

Bevor du eine Einstellung änderst, eine Erweiterung aktualisierst oder eine Datei anfasst, überprüfe Folgendes:

• Ich weiss, was zuletzt geändert wurde (oder ich habe überprüft, dass nichts geändert worden ist).
• Ich kann beschreiben, was wo, und für wen nicht funktioniert.
• Die Fehlerberichterstattung ist zunächst deaktiviert, sodass ich den Fehler so sehe, wie ihn die Benutzer sehen können.
• Ich habe Joomla, PHP oder Erweiterungen seit dem Auftreten des Fehlers nicht aktualisiert.
• Ich bin bereit, jeweils nur eine Änderung vorzunehmen und das Ergebnis zu beobachten.

Wenn du nicht alle diese Punkte abhaken kannst, bist du noch nicht bereit für die Fehlerbehebung.

Dies ist die Übersetzung des Artikels A No-Nonsense Guide to Troubleshooting Joomla von Brian Teeman. Er ist am 30. Januar 2026 auf der Seite von Brian publiziert worden.Ich habe ihn hier mit freundlicher Genehmigung des Autors ins Deutsche übertragen. Das Artikelbild ist mithilfe von ChatGPT entstanden.

Was Profis nicht tun

Profis tun Folgendes nicht:

• Joomla mitten in einem Vorfall aktualisieren.
• Erweiterungen installieren oder entfernen, „um zu sehen, ob es hilft“.
• Alles deaktivieren und es als Fehlerbehebung bezeichnen.
• Das CMS beschuldigen, bevor belastbare Beweise gesammelt worden sind.

Das sind keine Debugging-Techniken. Das sind Panikreaktionen.

Wenn ein Kunde dich für die Wartung seiner Website bezahlt, ist es nicht deine Aufgabe, beschäftigt zu wirken. Deine Aufgabe ist es, überlegt zu handeln.

Schritt 1: Stopp. Probiere nicht blind Dinge aus.

Bevor du irgendetwas anfasst, halte inne.

Aktualisiere Joomla nicht. Aktualisiere keine Erweiterungen. Beginne nicht, wahllos Dinge zu deaktivieren.

Jede Änderung, die du vornimmst, zerstört Beweise.

Notiere dir:

• Was sich unmittelbar vor dem Auftreten des Problems geändert hat.
• Ob dies Auswirkungen auf das Frontend, das Backend oder beides hat.
• Ob es überall oder nur auf einer Seite auftritt.

„Es hat sich nichts geändert” ist dennoch eine wichtige Information.

Schritt 2: Joomla dazu zwingen, die Wahrheit zu sagen

Joomla weiss fast immer, was schiefgelaufen ist. Das Problem ist, dass es auf unterschiedliche Weise fehlschlägt – und jedes Mal etwas anderes anzeigt.

Bevor du etwas änderst, solltest du herausfinden, welche Art von Fehlerseite du tatsächlich zu sehen bekommst.

Unterschiedliche Fehler erfordern unterschiedliche Reaktionen. Wenn du sie alle gleich behandelst, verschwendest du nur Zeit.

Deshalb ist Raten nicht nur ineffektiv, sondern auch unverantwortlich.

 Deaktiviere die Fehlerberichterstattung und das Debugging erst nach Abschluss des Debuggens, nicht vorher.

Schritt 3: Lese die Protokolle wie ein Erwachsener.

Joomla protokolliert Fehler kontinuierlich. Sie zu ignorieren ist eine Entscheidung.

Überprüfe:

• /administrator/logs/error.php 
• Das PHP-Fehlerprotokoll deines Servers.

Suche nach Mustern statt nach einzelnen Meldungen:

• Die gleiche Datei wird wiederholt erwähnt.
• Der gleiche Dateinamen erscheint immer wieder.
• Fehler treten unmittelbar nach einer bestimmten Aktion auf.

Ein Fehler kann eine Lüge sein. Wiederholungen hingegen nicht.

Überprüfe auch die Benutzeraktionsprotokolle.

Wenn mehr als eine Person Administratorzugriff hat, zeichnet Joomla auf, was sie tun – auch wenn sie behaupten, nichts getan zu haben.

Gehe zu Benutzer → Benutzeraktivitäten und suche nach:

• Installierten, aktualisierten oder entfernten Erweiterungen
• Änderungen an der globalen Konfiguration
• Änderungen an Plugins, Modulen oder Templates

Joomla vergisst nichts. Menschen schon.

Schritt 4: Caching deaktivieren, weil Caching täuscht

Caching dient dazu, Arbeit zu verbergen. Das macht es für die Fehlersuche ungeeignet.

In der globalen Konfiguration:

System - Cache deaktivieren
Plugin System - Seitencache deaktivieren (falls aktiviert)

Dann alles löschen:

System → Cache Alles löschen
System → Abgelaufenen Cache löschen

Erneut testen. Wenn das Problem mit deaktiviertem Cache „verschwindet”, hast du es nicht behoben. Du hast es nur aufgedeckt.

Schritt 5: Überprüfe, ob das Template schuld ist.

Templates sind die üblichen Verdächtigen.

Gehe zu System → Site Template Stile.
Lege Cassiopeia als Standard fest.
Lade die fehlerhafte Seite neu.

Wenn das Problem verschwindet, ist Joomla unschuldig. Der Fehler befindet sich in:

1. Deinem Template.
2. Einem Template Override dieses Templates.
3. JavaScript oder CSS dieses Templates.

Schritt 6: Deaktiviere Erweiterungen methodisch (nicht drastisch)

Erweiterungen von Drittanbietern verursachen die meisten Joomla-Fehler. Das ist unumstritten.

Deaktiviere nicht alles auf einmal. Das bringt dir nichts.

1. Deaktiviere zuerst Plugins, beginnend mit System- und Inhalts-Plugins.
2. Teste nach jeder einzelnen Änderung.
3. Aktiviere Plugins nach und nach wieder.

Wenn das Problem verschwindet, höre auf. Du habst die Ursache gefunden.

Wiederhole dies für:

• Module
• Komponenten (zuletzt – sie verursachen viele Probleme, wenn sie deaktiviert werden)

Schritt 7: Überprüfe die Kompatibilität, nicht den Optimismus.

Stelle eine langweilige Frage mit einer unspektakulären Antwort:

Ist diese Erweiterung tatsächlich mit dieser Joomla-Version und dieser PHP-Version kompatibel?

Überprüfe:

• Die Dokumentation der Erweiterung.
• Den Eintrag im Joomla-Erweiterungsverzeichnis.
• Den Issue Tracker.

Wenn er seit Jahren nicht aktualisiert wurde, hat Joomla ihn wohl kaum plötzlich verraten.

Schritt 8: Überprüfe Dateien, Pfade und Berechtigungen

Insbesondere nach Migrationen, Wiederherstellungen oder Host-Wechseln.

Vergewissere dich bezüglich Berechtigungen:

• Dateien sind in der Regel 644
• Ordner sind in der Regel 755
• Die Pfade zu /tmp und /logs sind korrekt
• Joomla kann in beide Verzeichnisse schreiben

Berechtigungsprobleme tarnen sich als zufällige Fehler. Sie sind nicht zufällig.

Schritt 9: Reproduziere den Fehler absichtlich

Wenn du den Fehler nicht reproduzieren kannst, kannst du ihn auch nicht beheben.

Teste daher Folgendes:

• Einen anderen Browser
• Ein privates Fenster
• Ein anderes Benutzerkonto
• Einen sauberen Menüpunkt, der auf denselben Inhalt verweist

Wenn der Fehler nur in einem bestimmten Kontext auftritt, ist dieser Kontext der Fehler.

Schritt 10: Bitte um Hilfe, aber ohne die Zeit anderer zu verschwenden

Wenn du um Hilfe bittest, bringe bitte Beweise mit:

• Joomla-Version (schreibe nicht „neueste Version”; eine Version hat immer eine Nummer)
• PHP-Version
• Vollständige Fehlermeldungen einschliesslich des Stack-Trace
• Was du deaktiviert oder geändert hast
• Was tatsächlich einen Unterschied gemacht hat

„Meine Website funktioniert nicht” ist keine Problembeschreibung. Es ist ein Eingeständnis, dass du die oben genannten Schritte übersprungen hast.

Was die Leute nicht gerne hören

Joomla ist selten defekt.

Denke daran: Joomla ist keine Glühbirne. Eine Glühbirne kann ohne Vorwarnung ausfallen. Joomla kann das nicht. Wenn Joomla defekt ist, hat jemand (wahrscheinlich du) etwas verursacht.

Was kaputt ist, ist in der Regel:

• Eine inkompatible Erweiterung.
• Eine Template-Überschreibung, an deren Hinzufügung sich niemand erinnern kann.
• Eine unachtsame Aktualisierungssequenz.
• Oder eine Hosting-Umgebung, die sich still und leise verändert hat.

Höre auf zu raten. Beginne mit der Fehlersuche. Joomla sagt dir, was falsch ist, wenn du es zulässt.

Und wenn du Websites für Kunden erstellst, ist dieser Teil wichtig. Jede zufällige Änderung, die du während eines Vorfalls vornimmst, untergräbt das Vertrauen. Kunden interessiert es nicht, wie schnell du in Panik gerätst. Sie interessieren sich dafür, dass du erklären kannst, was kaputt gegangen ist, warum es kaputt gegangen ist und wie du es repariert hast.

Durch Rätselraten verlieren Amateure das Vertrauen. Durch Debugging verdienen sich Profis das Vertrauen.

Setze am besten ein Lesezeichen auf diesen Leitfaden. Sende es an dein Team und höre auf, zu raten.