Magento-Probleme wie weißer Bildschirm und 500-Fehler können frustrierend sein. In diesem Leitfaden helfen wir Ihnen, die häufigsten Probleme zu lösen.

Erste Schritte bei Problemen

Bevor Sie mit der Fehlersuche beginnen:

  1. Überprüfen Sie die Fehlerprotokolle
  2. Schalten Sie den Entwicklungsmodus ein (vorübergehend)
  3. Prüfen Sie kürzliche Änderungen - Was hat sich geändert?
  4. Erstellen Sie ein Backup, bevor Sie etwas ändern

Entwicklungsmodus einschalten

Um detaillierte Fehlermeldungen zu sehen:

bin/magento deploy:mode:set developer

Achtung: Schalten Sie dies nach der Fehlersuche aus, um die Leistung zu verbessern.

Weißer Bildschirm beheben

Ein weißer Bildschirm (White Screen of Death) bedeutet einen fatalen PHP-Fehler.

Schritt 1: Fehlerprotokolle prüfen

# Magento-Fehlerprotokoll
tail -100 var/log/exception.log
tail -100 var/log/system.log

# PHP-Fehlerprotokoll
tail -100 /pfad/zu/logs/error.log

# Apache-Fehlerprotokoll
tail -100 /var/log/apache2/error.log

Schritt 2: PHP-Fehler anzeigen

Fügen Sie vorübergehend zu index.php hinzu:

ini_set('display_errors', 1);
error_reporting(E_ALL);

Schritt 3: Häufige Ursachen

Speicherlimit

# Aktuelles Limit prüfen
php -i | grep memory_limit

# Erhöhen über .htaccess
php_value memory_limit 2G

Beschädigter Cache

rm -rf var/cache/*
rm -rf var/page_cache/*
rm -rf generated/*

Berechtigungen

find var generated pub/static pub/media -type d -exec chmod 755 {} \;
find var generated pub/static pub/media -type f -exec chmod 644 {} \;
chmod u+x bin/magento

500 Internal Server Error

Schritt 1: .htaccess prüfen

Eine beschädigte .htaccess ist eine häufige Ursache:

  1. Benennen Sie .htaccess in .htaccess_backup um
  2. Laden Sie eine neue .htaccess von Magento GitHub herunter
  3. Testen Sie die Website

Schritt 2: PHP-Version

Prüfen Sie, ob die PHP-Version kompatibel ist:

  • Magento 2.4.6+: PHP 8.1 oder 8.2
  • Magento 2.4.4-5: PHP 8.1

Schritt 3: Datenbankverbindung

Testen Sie die Datenbankverbindung:

  1. Überprüfen Sie die Anmeldedaten in app/etc/env.php
  2. Testen Sie die Verbindung über phpMyAdmin
  3. Prüfen Sie, ob der Datenbankserver läuft

Schritt 4: DI-Kompilierung

rm -rf generated/*
bin/magento setup:di:compile

Cache-Probleme

Gesamten Cache leeren

bin/magento cache:clean
bin/magento cache:flush

Spezifischer Cache

# Nur Konfigurations-Cache
bin/magento cache:clean config

# Nur Full-Page-Cache
bin/magento cache:clean full_page

Manuelle Cache-Löschung

rm -rf var/cache/*
rm -rf var/page_cache/*
rm -rf var/view_preprocessed/*
rm -rf pub/static/frontend/*
rm -rf pub/static/adminhtml/*
rm -rf generated/*

Index-Probleme

Index-Status prüfen

bin/magento indexer:status

Alle Indizes neu aufbauen

bin/magento indexer:reindex

Spezifischer Index

bin/magento indexer:reindex catalog_product_price
bin/magento indexer:reindex catalogsearch_fulltext

Admin-Panel-Probleme

Admin lädt nicht

  1. Admin-URL prüfen

    bin/magento info:adminuri

  2. Admin-URL zurücksetzen

    bin/magento config:set admin/url/use_custom 0
bin/magento config:set admin/url/use_custom_path 0

  3. Cache leeren

    bin/magento cache:clean

Kann nicht einloggen

  1. Entsperren Sie das Konto und legen Sie bei Bedarf ein neues Admin-Konto an. Magento hat keinen CLI-Befehl, um das Passwort eines bestehenden Kontos zu ändern:

    bin/magento admin:user:unlock adminusername
bin/magento admin:user:create --admin-user=neueradmin --admin-password='WaehlenSieEinSicheresPasswort1' --admin-email=sie@example.de --admin-firstname=Vorname --admin-lastname=Nachname

    Melden Sie sich mit dem neuen Konto an und setzen Sie das Passwort des alten Kontos über System > Permissions > All Users zurück.

  2. Überprüfen Sie den Kontostatus in der Datenbank (admin_user-Tabelle)

Erweiterungsprobleme

Problematische Erweiterung finden

# Alle Erweiterungen deaktivieren
bin/magento module:disable --all

# Core-Module wieder aktivieren
bin/magento module:enable Magento_Backend Magento_Store ...

# Website testen

# Erweiterungen einzeln aktivieren
bin/magento module:enable Vendor_Module

Erweiterung notfallmäßig entfernen

Über die Datenbank, wenn CLI nicht funktioniert:

  1. Gehen Sie zu phpMyAdmin
  2. Suchen Sie die setup_module-Tabelle
  3. Entfernen Sie den problematischen Moduleintrag
  4. Leeren Sie den Cache manuell

Datenbankprobleme

Meldung "Please upgrade your database"

Diese Meldung erscheint, wenn der Code neuer ist als die Datenbank, zum Beispiel nach der Installation oder dem Update einer Erweiterung ohne setup:upgrade:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f de_DE
bin/magento cache:flush

Datenbank reparieren

# Über Magento CLI
bin/magento setup:db:status
bin/magento setup:db-schema:upgrade
bin/magento setup:db-data:upgrade

Tabellen über phpMyAdmin reparieren

  1. Wählen Sie alle Tabellen aus
  2. Wählen Sie "Tabelle reparieren" aus dem Dropdown-Menü
  3. Führen Sie es aus

Wartungsmodus

Versetzen Sie Ihren Shop in den Wartungsmodus, während Sie ein Problem beheben oder Updates durchführen, damit Besucher keine Fehlermeldungen oder einen halb funktionierenden Shop sehen:

# Einschalten
bin/magento maintenance:enable

# Status anzeigen
bin/magento maintenance:status

# Ausschalten
bin/magento maintenance:disable

Mit bin/magento maintenance:enable --ip=<Ihre IP-Adresse> behalten Sie während der Wartung selbst Zugriff auf den Shop.

Debugging-Tipps

Profiler einschalten

bin/magento dev:profiler:enable

Prüfen Sie dann die Profiler-Ausgabe am unteren Rand der Seite.

Abfrageprotokollierung

In app/etc/env.php:

'db' => [
    'connection' => [
        'default' => [
            'profiler' => [
                'class' => '\\Magento\\Framework\\DB\\Profiler',
                'enabled' => true
            ]
        ]
    ]
]

Browserkonsole

Kein PHP-Fehler, aber ein Teil der Seite funktioniert nicht (Schaltflächen reagieren nicht, der Checkout lädt nicht)? Öffnen Sie die Konsole Ihres Browsers (F12) und prüfen Sie, ob JavaScript-Fehler angezeigt werden.

XDebug

Konfigurieren Sie XDebug für Step-by-Step-Debugging in Ihrer IDE.

Wann Support einschalten

Kontaktieren Sie den Support, wenn:

  • Sie die Ursache nicht finden können
  • Es ein serverseitiges Problem zu sein scheint
  • Sie Änderungen benötigen, die Administratorrechte erfordern
  • Das Problem immer wieder auftritt

Verwandte Artikel

  • Fehlerprotokolle in DirectAdmin ansehen
  • Magento-Systemanforderungen
  • Magento-Backup erstellen

Hilfe benötigt?

Wir sind für Sie da! Haben Sie Fragen oder stoßen Sie auf Probleme? Unser Support-Team hilft Ihnen gerne persönlich weiter. Senden Sie uns eine Nachricht über das Ticketsystem - wir antworten in der Regel innerhalb weniger Stunden und denken gerne mit Ihnen mit.

Suchen Sie Server-Hosting? Sehen Sie sich unser Angebot an.