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

# 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 {} \;

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. Admin-Passwort zurücksetzen:

    bin/magento admin:user:unlock adminusername
bin/magento admin:user:change-password adminusername neuespasswort

  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

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

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
            ]
        ]
    ]
]

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

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.