Waarom toont de checkout in Magento een wit scherm bij grote winkelwagens (en hoe los je dat op)?

Magento 2 – wit scherm in checkout (white screen of death) bij een grote winkelwagen

Stel je een klant voor die tientallen producten aan de winkelwagen toevoegt… doorgaat naar de checkout… en in plaats van de kassa een wit scherm ziet.
Klinkt bekend? In Magento 2.4.x is dit geen zeldzaam probleem – en we hebben het net meegemaakt in een live project.

Symptomen

• De checkout werkte correct bij kleinere winkelwagens.

• Bij tientallen producten – een witte pagina.

• In de logs waren geen meldingen of fouten te vinden.

• Soms werkte de checkout, en even later gaf dezelfde winkelwagen een lege pagina.

Spoor nummer 1 – Redis?

De eerste verdenking viel op Redis: sessielocks, concurrency, timeouts.

Na het uitschakelen van Redis werden de sessies inderdaad wat rustiger, maar het probleem verdween helemaal niet.

Spoor nummer 2 – shipping.phtml

ddd

Tijdens het stap voor stap debuggen kwamen we uit bij het bestand:

vendor/magento/module-checkout/view/frontend/templates/cart/shipping.phtml

dat een enorme JSON laadde:

window.checkoutConfig = {$serializedCheckoutConfig};

Bron van het probleem – quoteItemData

Het bleek dat de boosdoener een regel in DefaultConfigProvider was:

$output['quoteItemData'] = $quoteItemData;

oftewel alle gegevens over de producten in de winkelwagen. En op deze plek laadde Magento onder andere custom_attributes_serializable, dat soms… honderden MB groot kon zijn.

Oplossing

De eenvoudigste fix: onnodige gegevens verwijderen voordat ze in checkoutConfig terechtkomen.

Dat hebben we gedaan met een plugin op QuoteItem::setProduct():

public function afterSetProduct( MagentoQuoteModelQuoteItem $subject, $result, $product) { // główny winowajca $subject->setData('custom_attributes_serializable', null); return $result;}

Het effect?

• De checkout begon stabiel te werken, zelfs bij grote winkelwagens.

• De JSON-payload daalde van enkele/tientallen MB naar een paar honderd KB.

Conclusies

• In Magento 2 kan de checkout erg gevoelig zijn voor wat er in quoteItemData terechtkomt.

• Als jullie problemen hebben met witte schermen in de winkelwagen/checkout – controleer dan de grootte van custom_attributes_serializable.

• Soms is één kleine plugin genoeg om de stabiliteit van de hele shop te redden.

Hebben jullie vergelijkbare avonturen met de checkout gehad? Welke andere vreemde gevallen hebben jullie winkelwagen in Magento stukgemaakt? Deel het in de reacties