Koszyk
Koszyk jest jeszcze pusty.
Błąd 500 w PrestaShop – jak szybko zdiagnozować i naprawić problem?
Błąd 500 w PrestaShop to jeden z najczęstszych problemów, z jakimi spotykają się właściciele sklepów internetowych. Choć wygląda poważnie i może skutecznie zablokować działanie sklepu, w wielu przypadkach jego diagnoza i naprawa są stosunkowo szybkie. W tym poradniku pokazuję, jak krok po kroku znaleźć przyczynę błędu 500 w PrestaShop i przywrócić poprawne działanie sklepu.
Krok 1. Wyczyść pamięć podręczną w panelu administracyjnym PrestaShop
Pierwszym krokiem przy diagnozie error 500 w PrestaShop powinno być wyczyszczenie pamięci podręcznej z poziomu panelu administracyjnego.
- Zaloguj się do back office sklepu.
- Przejdź do Zaawansowane > Wydajność.
- Kliknij przycisk „Wyczyść pamięć podręczną”.
Po wykonaniu tej operacji sprawdź, czy błąd 500 zniknął. W wielu przypadkach problem wynika właśnie z uszkodzonego lub nieaktualnego cache.
Krok 2. Usuń cache ręcznie z serwera FTP
Jeżeli błąd nadal występuje, kolejnym etapem jest ręczne usunięcie pamięci cache z serwera.
W tym celu:
- Połącz się z serwerem przez FTP.
- Przejdź do głównego katalogu sklepu.
- Otwórz folder var, a następnie cache.
- Usuń katalogi dev oraz prod.
Następnie odśwież sklep i sprawdź, czy PrestaShop nadal wyświetla błąd 500.
Krok 3. Włącz tryb debug w PrestaShop
Jeśli problem nadal występuje, najprawdopodobniej mamy do czynienia z bardziej złożoną usterką. W takiej sytuacji warto włączyć tryb debug, który często pokazuje dokładny komunikat błędu oraz miejsce jego występowania.
Debug mode w PrestaShop pozwala ustalić, czy problem dotyczy modułu, nadpisania, kontrolera, motywu lub innego elementu systemu.
Jeżeli w komunikacie błędu pojawia się ścieżka zawierająca słowo „module”, bardzo możliwe, że problem powoduje konkretny moduł. W takim przypadku najlepiej skontaktować się z jego twórcą, ponieważ powinien dostarczyć poprawkę lub wskazać rozwiązanie.
Jeżeli źródło problemu znajduje się w innym miejscu, warto poszukać rozwiązania w dokumentacji lub w internecie. Bardzo często jest to prosta usterka w kodzie, którą można szybko wyeliminować.
Krok 4. Gdy sklep działa tylko na debug mode, sprawdź logi serwera
Zdarza się również trudniejszy przypadek: po włączeniu debugowania sklep działa poprawnie, natomiast po jego wyłączeniu ponownie pojawia się error 500. Taka sytuacja zwykle oznacza, że potrzebna będzie analiza logów serwera.
Jeżeli korzystasz z serwera opartego o Apache, możesz tymczasowo dodać do pliku .htaccess poniższą konfigurację, aby zbierać błędy PHP do logów:
#Error reporting PHP
php_flag display_startup_errors on
php_flag display_errors on
php_flag html_errors on
php_flag log_errors on
php_flag ignore_repeated_errors off
php_flag ignore_repeated_source off
php_flag report_memleaks on
php_flag track_errors on
php_value docref_root 0
php_value docref_ext 0
php_value error_reporting -1
php_value log_errors_max_len 0
#End error reporting PHPPo zapisaniu zmian przejdź do logów serwera i sprawdź pliki access.log oraz error.log. Najlepiej szukać fraz takich jak „Fatal error”, ponieważ zwykle wskazują one dokładny plik i fragment kodu odpowiedzialny za awarię.
Najczęstsze przyczyny błędu 500 w PrestaShop
- uszkodzona pamięć podręczna,
- błąd w module lub jego aktualizacji,
- problem z nadpisaniami,
- niekompatybilność z wersją PHP,
- błąd w plikach motywu,
- usterka w kodzie po wdrożeniu zmian.
Podsumowanie
Diagnoza błędu 500 w PrestaShop nie zawsze jest skomplikowana. Najczęściej wystarczy wyczyścić cache, usunąć pliki pamięci podręcznej z serwera lub uruchomić tryb debug, aby szybko namierzyć źródło problemu. W bardziej zaawansowanych przypadkach kluczowa będzie analiza logów serwera i błędów PHP.
Jeżeli potrzebujesz wsparcia w naprawie sklepu, optymalizacji działania lub diagnozie problemów technicznych w PrestaShop, napisz na: jakub@modules4presta.io. Chętnie pomożemy rozwiązać problem.
Komentarze (0)