Magento problemen zoals wit scherm en 500 errors kunnen frustrerend zijn. In deze handleiding helpen we je de meest voorkomende problemen op te lossen.

Eerste stappen bij problemen

Voordat je begint met troubleshooten:

  1. Controleer de error logs
  2. Schakel development mode in (tijdelijk)
  3. Check recente wijzigingen - wat is er veranderd?
  4. Maak een backup voordat je iets aanpast

Developer mode inschakelen

Om gedetailleerde foutmeldingen te zien:

bin/magento deploy:mode:set developer

Let op: Schakel dit uit na troubleshooting voor betere performance.

Wit scherm oplossen

Een wit scherm (White Screen of Death) betekent een fatale PHP error.

Stap 1: Check error logs

# Magento error log
tail -100 var/log/exception.log

# PHP error log
tail -100 /pad/naar/logs/error.log

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

Stap 2: PHP errors tonen

Voeg tijdelijk toe aan index.php:

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

Stap 3: Veelvoorkomende oorzaken

Memory limit

# Check huidige limiet
php -i | grep memory_limit

# Verhoog via .htaccess
php_value memory_limit 2G

Corrupte cache

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

Permissies

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

Stap 1: Check .htaccess

Een corrupte .htaccess is een veelvoorkomende oorzaak:

  1. Hernoem .htaccess naar .htaccess_backup
  2. Download een verse .htaccess van Magento GitHub
  3. Test de website

Stap 2: PHP versie

Controleer of de PHP versie compatible is:

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

Stap 3: Database connectie

Test de database connectie:

  1. Check credentials in app/etc/env.php
  2. Test connectie via phpMyAdmin
  3. Controleer of database server draait

Stap 4: DI compilatie

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

Cache problemen

Alle cache legen

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

Specifieke cache

# Alleen configuratie cache
bin/magento cache:clean config

# Alleen full page cache
bin/magento cache:clean full_page

Handmatige cache verwijdering

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 problemen

Index status controleren

bin/magento indexer:status

Alle indexen opnieuw opbouwen

bin/magento indexer:reindex

Specifieke index

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

Admin panel problemen

Admin laadt niet

  1. Check admin URL

    bin/magento info:adminuri

  2. Reset admin URL

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

  3. Leeg cache

    bin/magento cache:clean

Kan niet inloggen

  1. Reset admin wachtwoord:

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

  2. Check account status in database (admin_user tabel)

Extensie problemen

Problematische extensie vinden

# Schakel alle extensies uit
bin/magento module:disable --all

# Schakel core modules weer in
bin/magento module:enable Magento_Backend Magento_Store ...

# Test website

# Schakel extensies een voor een in
bin/magento module:enable Vendor_Module

Extensie noodverwijdering

Via database als CLI niet werkt:

  1. Ga naar phpMyAdmin
  2. Zoek setup_module tabel
  3. Verwijder de problematische module entry
  4. Leeg var/cache manueel

Database problemen

Database repareren

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

Tabellen repareren via phpMyAdmin

  1. Selecteer alle tabellen
  2. Kies "Repair table" uit dropdown
  3. Voer uit

Debugging tips

Profiler inschakelen

bin/magento dev:profiler:enable

Check dan Profiler output onderin de pagina.

Query logging

In app/etc/env.php:

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

XDebug

Configureer XDebug voor step-by-step debugging in je IDE.

Wanneer support inschakelen

Neem contact op met support als:

  • Je de oorzaak niet kunt vinden
  • Het een server-level probleem lijkt
  • Je wijzigingen nodig hebt die admin rechten vereisen
  • Het probleem blijft terugkomen

Gerelateerde artikelen

Hulp nodig?

We staan voor je klaar! Loop je ergens tegenaan of heb je vragen? Ons supportteam helpt je graag persoonlijk verder. Stuur ons een berichtje via het ticketsysteem - we reageren meestal binnen een paar uur en denken graag met je mee.