Błąd 500 lub biały ekran w PrestaShop: co zrobić teraz

Otwierasz sklep w poniedziałek rano i widzisz tylko „Error 500” albo zupełnie pustą stronę, a zamówienia z weekendu czekają. Błąd 500 w PrestaShop albo biały ekran prawie nigdy nie oznacza, że straciłeś sklep: oznacza, że coś zawiodło za kulisami, a PrestaShop nie umie Ci powiedzieć co. Najpierw nie ruszaj niczego na ślepo; potem albo zdiagnozuj to według kroków poniżej, albo przekaż problem komuś, kto zajmie się nim w mniej niż 12 godzin.

Co oznacza błąd 500 w PrestaShop?

To ogólny komunikat serwera: „coś poszło nie tak i nie mogę dokończyć ładowania strony”. Nie mówi co. Biały ekran to to samo, tylko nawet bez komunikatu: sklep jest ustawiony tak, żeby nie pokazywać błędów klientom, więc nie pokazuje nic.

Dobra wiadomość jest taka, że Twoje produkty, klienci i zamówienia nadal są w bazie danych. Zepsuła się część, która je wyświetla, a to da się naprawić.

Dlaczego mój sklep nagle przestał działać?

Prawie zawsze tuż wcześniej coś się zmieniło. Najczęstsze przyczyny to:

• Nowy albo zaktualizowany moduł, który gryzie się z innym albo z Twoją wersją PrestaShop.
• Aktualizacja PrestaShop albo szablonu, która zatrzymała się w połowie.
• Zmiana na Twoim hostingu: dostawca podniósł wersję PHP (języka, w którym działa PrestaShop), a Twój sklep nie jest zgodny z nową.
• Pamięć podręczna, czyli pliki tymczasowe, które PrestaShop trzyma, żeby działać szybciej, jest nieaktualna albo uszkodzona.
• Serwerowi kończy się pamięć na najcięższych stronach, takich jak katalog albo panel.
• Uprawnienia plików źle ustawione po przeniesieniu sklepu albo wgraniu czegoś przez FTP.

Zanim zrobisz cokolwiek innego, przypomnij sobie: co zostało zainstalowane, zaktualizowane albo zmienione w ostatnich dniach? Ta odpowiedź oszczędza połowę pracy.

Co zrobić teraz, żeby nie pogorszyć sprawy?

1. Nie instaluj PrestaShop od nowa i nie zaczynaj usuwać modułów na chybił trafił. Odinstalowanie modułu może skasować jego ustawienia i dane.
2. Poproś dostawcę hostingu o kopię zapasową plików i bazy danych dokładnie w obecnym stanie albo zrób ją sam z jego panelu. Dzięki temu każdy test da się cofnąć.
3. Sprawdź, czy nie działa wszystko, czy tylko jedna część. Strona główna, tylko koszyk, tylko panel? Zapisz to: to pierwsza wskazówka.
4. Zrób zrzut ekranu tego, co widzisz, z widocznym adresem strony.

Jak zobaczyć prawdziwy błąd za białym ekranem?

PrestaShop ma tryb debugowania, który zamiast pustej strony pokazuje pełny komunikat błędu. Ten komunikat zwykle mówi, który plik albo który moduł zawiódł.

Jeśli panel nadal się otwiera, włącz go w Zaawansowane > Wydajność > Tryb debugowania. Jeśli panel też się nie otwiera, trzeba to zrobić, edytując plik przez FTP; wyjaśniamy to w ostatniej części, dla Twojego zespołu technicznego.

Ważne ostrzeżenie: przy włączonym trybie debugowania Twoi klienci też widzą błędy. Używaj go tylko tak długo, jak potrzebujesz, żeby przeczytać komunikat, a potem znowu go wyłącz.

Drugie źródło wskazówek to log błędów: PrestaShop zapisuje błędy w folderze var/logs Twojego sklepu, a hosting zwykle ma własny log błędów PHP w panelu klienta.

Czy mogę to naprawić sam, nie umiejąc programować?

Czasem tak. Są trzy rzeczy, które sprawdzisz bez ruszania kodu:

Wyczyść pamięć podręczną

W panelu, w Zaawansowane > Wydajność, kliknij Wyczyść pamięć podręczną. Jeśli panel się nie otwiera, Twój zespół techniczny może ją wyczyścić, usuwając zawartość jednego folderu. To bezpieczne: PrestaShop sam odtwarza te pliki.

Wyłącz ostatni moduł, który ruszałeś

Jeśli problem zaczął się po instalacji albo aktualizacji modułu, wyłącz go (nie odinstalowuj) w Moduły > Menedżer modułów. Jeśli sklep wróci, wiesz, kto był winny.

Zapytaj dostawcę hostingu, czy coś się zmieniło

Jedno proste pytanie: „Czy w ostatnich dniach zmieniliście wersję PHP albo jakiś limit serwera?”. Każda wersja PrestaShop działa tylko z określonymi wersjami PHP, a taka zmiana może położyć sklep z dnia na dzień.

Jeśli po tym wszystkim nadal jest tak samo, przestań testować. Każda próba na ślepo to więcej czasu z zamkniętym sklepem i większe ryzyko ruszenia czegoś, co akurat działało.

Ile kosztuje naprawa?

W BK Modules oferujemy pilne wsparcie techniczne PrestaShop: płacisz za godzinę pracy technika, 45 € (stawka z października 2026), a my bierzemy się do roboty. Pracujemy 7 dni w tygodniu. Błędy 500, białe ekrany i panel, który się nie otwiera, są na samej górze listy rzeczy, które naprawiamy.

Tak to działa:

1. Płacisz za godzinę. Możesz napisać, co widzisz, podać adres sklepu i dołączyć zrzuty ekranu albo log błędów, ale to nieobowiązkowe: żeby zapłacić, nie musisz niczego tłumaczyć.
2. Technik pisze do Ciebie w mniej niż 12 godzin, 7 dni w tygodniu, z tym, co widzimy, i jak to naprawimy. Wtedy poprosimy o dostęp do sklepu i, jeśli trzeba, do hostingu, bezpiecznym kanałem. Nigdy w formularzu.
3. Jeśli naprawimy to w ciągu tej godziny, gotowe. Jeśli trzeba więcej, zatrzymujemy się i mówimy Ci, co zostało i ile to potrwa. Ty decydujesz, czy kontynuujemy; nic nie jest pobierane bez Twojej zgody.

Pracujemy z PrestaShop 1.6, 1.7, 8 i 9, a faktura jest na Twoim koncie zaraz po zapłacie. To my tworzymy moduły do PrestaShop, więc wiemy od środka, co zwykle się psuje.

Jak sprawić, żeby to się nie powtórzyło?

Większość tych błędów bierze się z aktualizacji wgranej bez testów albo ze zmiany na serwerze, o której nikt nie uprzedził. Ktoś, kto zna Twój sklep i testuje aktualizacje przed ich wgraniem, oszczędza Ci prawie wszystkich takich nerwów.

Właśnie tym jest roczna opieka nad PrestaShop: testowane aktualizacje, kopie zapasowe, monitoring i godziny w ciągu roku na wypadek, gdy coś pójdzie nie tak.

Dla Twojego zespołu technicznego

Jeśli panel się nie otwiera, tryb debugowania włącza się w config/defines.inc.php, zmieniając false na true w tej linii:

define('_PS_MODE_DEV_', true);

• Logi: folder sklepu var/logs/ oraz log błędów PHP serwera.
• Pamięć podręczna: usuń zawartość var/cache/prod/ i var/cache/dev/.
• Podejrzany moduł bez dostępu do panelu: zmień nazwę jego folderu w modules/, żeby PrestaShop go nie ładował.
• Pamięć: PHP memory_limit co najmniej 256 MB.
• Uprawnienia: foldery 755 i pliki 644, z var/, img/ i upload/ z prawem zapisu dla użytkownika serwera WWW.
• PHP: sprawdź, czy aktywna wersja jest zgodna z zainstalowaną wersją PrestaShop.

Na koniec ustaw _PS_MODE_DEV_ z powrotem na false.