SKLEPINTERNETOWY.BIZPoradniki i wiedza e-commerce
Poradnik›BEZPIECZEŃSTWO›Shopware – błąd eksportu produktów powoduje wyczerpanie pamięci…
BEZPIECZEŃSTWO

Shopware – błąd eksportu produktów powoduje wyczerpanie pamięci RAM i awarie MySQL

11 listopada 202611 min czytanianetpoint

Poważny błąd w Shopware może doprowadzić do wyczerpania pamięci RAM serwera, zatrzymywania procesów MySQL i czasowej niedostępności sklepu internetowego. Problem został zgłoszony 10 listopada 2026 roku i dotyczy mechanizmu eksportu produktów, wykorzystywanego między innymi do generowania plików produktowych dla Google Shopping.

W udokumentowanym przypadku eksport katalogu obejmującego około 9000 wariantów produktów zużywał aż 6,2 GB pamięci RAM. Po zastosowaniu obejścia zużycie pamięci spadło do 2,1 GB, czyli o około 66%, bez zmiany zawartości wygenerowanego pliku CSV.

Najpoważniejszym skutkiem błędu były powtarzające się awarie procesów odpowiedzialnych za obsługę zadań w tle oraz serwera baz danych MySQL. Oznacza to, że pozornie zwykły eksport produktów może w określonych warunkach zagrozić działaniu całego sklepu.

Na czym polega błąd eksportu produktów w Shopware?

Problem został opisany w oficjalnym repozytorium Shopware na GitHubie jako zgłoszenie #22779 dotyczące TwigVariableParser.

Potwierdzono jego występowanie w Shopware 6.7.14.1. Autor zgłoszenia wskazał również, że problematyczny mechanizm pozostawał obecny w aktualnej gałęzi rozwojowej projektu w dniu zgłoszenia.

Źródłem problemu jest nieprawidłowa interpretacja zmiennych w szablonach Twig, które Shopware wykorzystuje podczas generowania eksportów produktowych.

Za analizowanie zmiennych odpowiada komponent TwigVariableParser. Wyniki jego działania są następnie wykorzystywane przez ProductExportGenerator::getAssociations() do określenia, jakie informacje o produktach należy pobrać z bazy danych.

W określonych sytuacjach parser błędnie łączy kilka odwołań do właściwości produktów w jedną nieprawidłową ścieżkę. W efekcie Shopware pobiera znacznie więcej danych, niż potrzebuje do utworzenia pliku eksportowego.

Dlaczego Shopware zużywa tak dużo pamięci RAM podczas eksportu?

W szablonach eksportowych często stosuje się instrukcje warunkowe pozwalające sprawdzić, czy produkt posiada określoną właściwość, na przykład zdjęcie, producenta lub przypisaną kategorię.

Przykładowy fragment szablonu Twig może wyglądać następująco:

{% set url = product.cover ? product.cover.media.url : '' %}
{{ url }}

Instrukcja sprawdza, czy produkt posiada zdjęcie główne. Jeśli tak, pobiera jego adres URL. Jeśli nie, zwraca pustą wartość.

Sama konstrukcja jest poprawna, jednak w dotkniętej błędem wersji Shopware parser może zinterpretować ją nieprawidłowo.

Zamiast oddzielnie rozpoznać właściwości produktu, tworzy dodatkową ścieżkę:

product.cover.product.cover.media.url

Następnie mechanizm eksportu wykorzystuje tę ścieżkę do budowania powiązań danych pobieranych z bazy.

W rezultacie mogą powstawać niepotrzebne relacje, takie jak:

cover.product.cover.media

To powoduje ponowne wczytywanie danych produktów oraz ich powiązanych elementów. W katalogach obejmujących tysiące produktów i wariantów ilość niepotrzebnie pobieranych danych może być bardzo duża.

Problem może dotyczyć również innych właściwości produktów

Podobne zachowanie może występować podczas korzystania z instrukcji warunkowych odwołujących się do:

  • zdjęć produktów i ich galerii,
  • producentów oraz marek,
  • kategorii głównych i dodatkowych,
  • grup wariantów produktów,
  • atrybutów i opcji produktowych,
  • innych powiązanych danych wykorzystywanych w eksportach.

Nie oznacza to, że każdy szablon wykorzystujący instrukcje warunkowe jest niebezpieczny. Problem dotyczy konkretnych konstrukcji, które powodują nieprawidłowe rozpoznawanie zależności między danymi.

Eksport 9000 wariantów produktów zużywał 6,2 GB RAM

Autor zgłoszenia przeprowadził test na kopii danych produkcyjnych sklepu posiadającego około 9000 wariantów produktów.

Badanie dotyczyło generowania pliku CSV dla Google Shopping przy ustawieniu read_buffer_size na poziomie 200.

Parametr Wynik
Wersja Shopware 6.7.14.1
Liczba wariantów Około 9000
Rodzaj eksportu Google Shopping CSV
Zużycie RAM przed zmianą szablonu 6,2 GB
Zużycie RAM po zmianie szablonu 2,1 GB
Spadek zużycia pamięci Około 66%

Po zastąpieniu problematycznych instrukcji warunkowych klasycznymi blokami Twig if zużycie pamięci zmniejszyło się o około 4,1 GB.

Co istotne, wygenerowany plik CSV pozostał identyczny. Oznacza to, że ograniczenie zużycia zasobów nie wymagało usuwania informacji o produktach ani zmniejszania katalogu eksportowego.

Przedstawione wyniki dotyczą konkretnego środowiska i nie oznaczają, że każdy sklep Shopware będzie zużywał podobną ilość pamięci.

Shopware może doprowadzić do zatrzymania MySQL i niedostępności sklepu

Najpoważniejszym skutkiem opisanego problemu było wyczerpanie dostępnej pamięci operacyjnej serwera.

W środowisku produkcyjnym, którego dotyczy zgłoszenie, system Linux wielokrotnie uruchamiał mechanizm OOM Killer.

OOM Killer odpowiada za awaryjne kończenie procesów, gdy system nie może przydzielić wymaganej ilości pamięci RAM.

W opisanym przypadku mechanizm ten zatrzymywał zarówno procesy Shopware Messenger Workers, jak i serwer MySQL.

Jakie mogą być konsekwencje dla sklepu internetowego?

  • Przerwanie eksportu produktów: pliki CSV i XML mogą nie zostać wygenerowane lub zaktualizowane.
  • Nieaktualne dane w Google Shopping: zewnętrzne systemy mogą nie otrzymać aktualnych cen, stanów magazynowych i informacji o produktach.
  • Zatrzymywanie zadań w tle: procesy Messenger Workers mogą kończyć działanie przed wykonaniem zaplanowanych operacji.
  • Awaria bazy danych: MySQL może zostać zatrzymany z powodu braku dostępnej pamięci.
  • Błędy HTTP 500: aplikacja może przestać prawidłowo odpowiadać na żądania klientów.
  • Problemy z realizacją zakupów: niedostępność bazy danych może uniemożliwić prawidłowe działanie koszyka, checkoutu i zapisywanie zamówień.

Potwierdzonym skutkiem w opisanym środowisku było zatrzymywanie procesów przez OOM Killer. Nie oznacza to jednak, że każdy eksport produktów w Shopware powoduje awarię MySQL.

Ryzyko zależy między innymi od konfiguracji serwera, liczby jednocześnie wykonywanych zadań, wielkości katalogu i dostępnej pamięci operacyjnej.

Jak rozpoznać problem z pamięcią RAM podczas eksportu Shopware?

Jeżeli sklep okresowo przestaje odpowiadać, a awarie występują podczas generowania plików produktowych, warto rozpocząć diagnostykę od powiązania czasu eksportu z obciążeniem serwera.

1. Sprawdź harmonogram eksportów produktowych

W panelu administracyjnym Shopware sprawdź konfigurację eksportów produktów oraz powiązanych kanałów sprzedaży.

Zwróć szczególną uwagę na integracje z Google Shopping i porównywarkami cenowymi, które automatycznie odświeżają dane produktowe.

Jeżeli problemy występują regularnie o podobnych godzinach, sprawdź, czy pokrywają się z wykonywaniem zadań eksportowych.

2. Sprawdź logi OOM Killer na serwerze Linux

Na serwerach wykorzystujących systemd można sprawdzić komunikaty jądra systemu poleceniem:

journalctl -k --since "24 hours ago" | grep -Ei 'out of memory|oom-kill|killed process'

Poszukaj informacji o procesach PHP, MySQL oraz pracownikach Shopware Messenger.

Jeżeli logi wskazują na zakończenie procesów z powodu braku pamięci, porównaj godzinę zdarzenia z harmonogramem eksportów.

3. Zweryfikuj stan MySQL lub MariaDB

W przypadku serwera MySQL sprawdź status usługi:

systemctl status mysql

Następnie przejrzyj ostatnie wpisy dziennika:

journalctl -u mysql --since "24 hours ago"

Jeżeli sklep korzysta z MariaDB, zastosuj odpowiednią nazwę usługi.

Sprawdź, czy w czasie generowania eksportu występowały nieoczekiwane restarty bazy danych, problemy z połączeniami lub zakończenia procesów.

4. Przeanalizuj szablony Twig

W szablonach eksportowych poszukaj instrukcji przypisujących wartości za pomocą operatora warunkowego.

Przykładowo:

{% set image = product.cover ? product.cover.media.url : '' %}

{% set brand = product.manufacturer ? product.manufacturer.name : '' %}

Takie konstrukcje warto sprawdzić w pierwszej kolejności, zwłaszcza jeżeli odnoszą się do kilku powiązanych właściwości produktu.

5. Porównaj wykorzystanie pamięci przed zmianą i po zmianie szablonu

Najbezpieczniej przeprowadzić test na kopii sklepu zawierającej reprezentatywne dane produktowe.

Wykonaj eksport z dotychczasowym szablonem, a następnie powtórz operację po zastąpieniu problematycznych instrukcji warunkowych blokami if.

Porównaj maksymalne zużycie pamięci, czas wykonywania eksportu oraz zawartość wygenerowanych plików.

Jak naprawić błąd TwigVariableParser w Shopware?

W zgłoszeniu opisano obejście polegające na zastąpieniu określonych instrukcji warunkowych standardowymi blokami Twig.

Przykład problematycznej instrukcji

{% set url = product.cover ? product.cover.media.url : '' %}
{{ url }}

Przykład poprawionej instrukcji

{% set url = '' %}
{% if product.cover %}
    {% set url = product.cover.media.url %}
{% endif %}
{{ url }}

Obie konstrukcje powinny zwracać taką samą wartość, ale druga nie wykorzystuje operatora warunkowego w przypisaniu zmiennej.

W opisanym przypadku taka zmiana pozwoliła uniknąć tworzenia nieprawidłowych powiązań danych przez parser Shopware.

Podobną zasadę można zastosować przy pobieraniu danych producenta:

{% set brand = '' %}
{% if product.manufacturer %}
    {% set brand = product.manufacturer.name %}
{% endif %}
{{ brand }}

Przed zastosowaniem zmian w sklepie produkcyjnym należy zachować kopię oryginalnego szablonu i porównać wygenerowane pliki eksportowe.

Nie ma potrzeby bezpośredniego modyfikowania plików źródłowych platformy, jeżeli problem można wyeliminować przez odpowiednią zmianę szablonu eksportu.

Czy producent Shopware przygotował już poprawkę?

10 listopada 2026 roku opublikowano Pull Request #22789, zawierający proponowaną poprawkę mechanizmu TwigVariableParser.

Zmiana polega na ograniczeniu sposobu tworzenia aliasów zmiennych. Parser ma tworzyć alias wyłącznie wtedy, gdy przypisana wartość odpowiada jednej ścieżce danych.

Jeżeli wyrażenie zawiera kilka ścieżek, na przykład w instrukcji warunkowej, nie powinny być one łączone w jedno nieprawidłowe powiązanie.

Do poprawki dołączono testy obejmujące instrukcje warunkowe oraz pętle Twig.

Według informacji dostępnych 11 listopada 2026 roku zgłoszenie i powiązany Pull Request pozostają otwarte. Nie ma jeszcze potwierdzenia, że poprawka została opublikowana w stabilnej wersji Shopware.

Dlatego przed aktualizacją należy sprawdzić oficjalną historię zmian i upewnić się, że dana wersja rzeczywiście zawiera rozwiązanie tego problemu.

Czy zwiększenie limitu pamięci PHP rozwiąże problem?

Zwiększenie limitu memory_limit może ograniczyć występowanie błędów związanych z przekroczeniem pamięci przez pojedynczy proces PHP, ale nie usuwa przyczyny niepotrzebnego pobierania danych.

W niektórych środowiskach podniesienie limitów pamięci może nawet pogorszyć sytuację, ponieważ wiele jednocześnie działających procesów będzie mogło zużywać większą część dostępnego RAM.

Jeżeli na tym samym serwerze działają Shopware, PHP i MySQL, nadmierne zużycie pamięci przez eksport może pozostawić zbyt mało zasobów dla bazy danych.

Dlatego skuteczniejsze działania obejmują:

  • usunięcie problematycznych instrukcji ze szablonów eksportowych,
  • kontrolowanie liczby jednocześnie działających procesów eksportowych,
  • monitorowanie wykorzystania pamięci RAM i swap,
  • analizowanie logów OOM Killer,
  • zapewnienie odpowiedniej rezerwy pamięci dla MySQL,
  • testowanie dużych eksportów poza środowiskiem produkcyjnym,
  • wdrożenie oficjalnej poprawki po jej udostępnieniu i zweryfikowaniu.

W przypadku sklepów wykorzystujących własny VPS lub serwer dedykowany istotne znaczenie ma prawidłowa konfiguracja całego środowiska. Odpowiednio prowadzona administracja serwerami VPS i dedykowanymi pozwala monitorować zasoby i szybciej identyfikować procesy destabilizujące działanie usług.

Czy awaria eksportu produktów może wpłynąć na sprzedaż i Google Shopping?

Tak. Eksport produktów jest istotnym elementem integracji sklepu z zewnętrznymi systemami reklamowymi i sprzedażowymi.

Jeżeli Shopware nie wygeneruje aktualnego pliku produktowego, systemy wykorzystujące taki plik mogą nie otrzymać nowych informacji o cenach, dostępności i asortymencie.

Może to powodować opóźnienia aktualizacji produktów w Google Merchant Center oraz innych zewnętrznych katalogach.

Jeszcze poważniejsze konsekwencje występują wtedy, gdy nadmierne zużycie pamięci prowadzi do zatrzymania bazy danych.

Wówczas sklep internetowy może przestać prawidłowo obsługiwać klientów, a przerwa w dostępności może oznaczać utracone zamówienia.

Nie ma jednak dowodów, że opisywany błąd automatycznie powoduje utratę danych zamówień lub trwałe uszkodzenie bazy. Potwierdzono natomiast możliwość zatrzymania procesów serwera w wyniku wyczerpania pamięci.

Jakich wersji Shopware dotyczy problem?

Problem został udokumentowany dla Shopware 6.7.14.1. Autor zgłoszenia wskazał również, że odpowiedni fragment mechanizmu TwigVariableParser pozostawał niezmieniony w aktualnej gałęzi rozwojowej projektu.

Nie opublikowano jeszcze pełnej listy wszystkich stabilnych wersji dotkniętych błędem.

Nie należy zatem zakładać, że problem występuje w każdej wersji Shopware ani że dowolna aktualizacja automatycznie go rozwiąże.

Najczęściej zadawane pytania

Czy błąd Shopware dotyczy wszystkich sklepów internetowych?

Nie. Wystąpienie problemu zależy przede wszystkim od konstrukcji szablonów eksportowych, struktury danych produktowych i konfiguracji środowiska serwerowego.

Czy eksport produktów może naprawdę zatrzymać MySQL?

Tak. W udokumentowanym przypadku eksport powodował tak duże zużycie pamięci, że system Linux zatrzymywał proces MySQL przez mechanizm OOM Killer.

Czy problem występuje tylko podczas eksportu do Google Shopping?

Nie musi. Przyczyna znajduje się w mechanizmie analizowania zmiennych Twig, z którego korzysta eksport produktów. Podobne konstrukcje szablonów mogą występować również w plikach przygotowywanych dla innych zewnętrznych systemów.

Czy trzeba wyłączyć automatyczny eksport produktów?

Nie zawsze. W pierwszej kolejności należy sprawdzić szablony Twig oraz rzeczywiste zużycie pamięci. Jeżeli eksport powoduje awarie serwera, jego czasowe wstrzymanie do zakończenia diagnostyki może być uzasadnione.

Czy poprawienie szablonu zmieni dane w pliku CSV?

W teście opisanym przez autora zgłoszenia plik wynikowy był identyczny przed zmianą i po zmianie szablonu. Mimo to każdą modyfikację warto zweryfikować na danych konkretnego sklepu.

Czy dostępna jest już oficjalna aktualizacja naprawiająca błąd?

Według stanu na 11 listopada 2026 roku przygotowano propozycję poprawki kodu, ale nie potwierdzono jeszcze jej udostępnienia w stabilnym wydaniu Shopware.

Co powinni zrobić administratorzy sklepów Shopware?

Sklepy posiadające rozbudowane katalogi produktów, liczne warianty oraz automatyczne integracje z zewnętrznymi systemami powinny zweryfikować zużycie pamięci podczas eksportów.

Szczególnie istotne jest sprawdzenie sytuacji, w których serwer przestaje odpowiadać cyklicznie, a w logach pojawiają się informacje o zakończeniu procesów PHP lub MySQL z powodu braku dostępnej pamięci.

Jeżeli przyczyną okazuje się mechanizm TwigVariableParser, zastosowanie udokumentowanego obejścia może znacząco zmniejszyć obciążenie serwera bez ograniczania zakresu eksportowanych danych.

W przypadku utrzymujących się awarii Shopware, problemów z bazą danych lub przeciążenia serwera można skorzystać ze wsparcia technicznego netPOINT, obejmującego diagnostykę sklepów internetowych, konfigurację środowisk hostingowych i administrację serwerami.

Źródła techniczne

netpoint

Materiały o e-commerce, sprzedaży i technologii dla sklepów internetowych.

Czytaj dalej

Powiązane materiały