Wykryj przyczynę błędu 500, 502 lub 504 na podstawie logów Nginx, Apache i PHP

Wklej ostatnie linijki z pliku error.log lub plik .htaccess, aby szybko przywrócić niedziałającą witrynę po przekroczeniu limitu pamięci PHP, zawieszeniu PHP-FPM lub błędzie składni.

W następnym kroku dodasz zdjęcie lub plik PDF w oknie rozmowy

Szybka ścieżka diagnostyki padniętej strony WWW

  1. 01

    Rozróżnij znaczenie kodów 500 (aplikacja), 502 (proces) i 504 (czas)

    Kod 500 to najczęściej błąd w PHP lub .htaccess; 502 oznacza, że backend (PHP-FPM/Node) padł lub nie słucha na gnieździe; 504 to przekroczony czas oczekiwania.

  2. 02

    Zawsze zaczynaj od odczytu końcówki pliku error.log serwera

    Przeglądarka celowo ukrywa przyczynę przed odwiedzającymi — dokładny numer linii i nazwa wadliwego pliku czekają w logach błędów panelu hostingowego.

  3. 03

    Sprawdź wolne miejsce na dysku oraz wolne węzły i-node (df -h / df -i)

    Całkowite zapełnienie dysku przez stare logi lub kopie zapasowe uniemożliwia zapis sesji i gniazd bazy MySQL, kładąc całą witrynę błędem 500.

  4. 04

    Cofnij ostatnią zmianę wersji PHP lub wyłącz folder problematycznej wtyczki

    Jeśli panel administracyjny nie odpowiada, zmiana nazwy katalogu wadliwego modułu przez SFTP natychmiast dezaktywuje go i przywraca dostęp.

Przykład działania

Wycinek z pliku /var/log/nginx/error.log

2026/11/14 14:12:08 [error] 1142#1142: *89412 connect() to unix:/run/php/php8.3-fpm.sock failed (11: Resource temporarily unavailable) while connecting to upstream W logu php8.3-fpm.log: WARNING: [pool www] server reached pm.max_children setting (5), consider raising it

Diagnoza wąskiego gardła i bezpieczna kalkulacja

Przyczyna błędu 502 jest podana na tacy: pula procesów PHP-FPM ma domyślny fabryczny limit `pm.max_children = 5`. Wystarczy 6 jednoczesnych zapytań do sklepu, aby kolejka gniazda Unix się przepełniła. Jak dobrać nową wartość bez zabicia serwera brakiem RAM (OOM Killer): 1. Sprawdź na VPS wolną pamięć dla PHP (np. masz 4 GB RAM, baza MySQL i system biorą 1,5 GB -> zostaje bezpieczne 2 GB = 2048 MB dla PHP). 2. Sprawdź średni rozmiar jednego procesu `php-fpm` (zwykle 60–80 MB dla WordPress/WooCommerce). 3. Podziel 2048 MB / 75 MB ≈ **25 procesów**. 4. Edytuj `/etc/php/8.3/fpm/pool.d/www.conf`, ustaw `pm = dynamic`, `pm.max_children = 25`, `pm.start_servers = 6`, `pm.min_spare_servers = 4`, `pm.max_spare_servers = 12`, przetestuj składnię `php-fpm8.3 -t` i przeładuj usługę `systemctl reload php8.3-fpm`.

Zamiast zgadywać losowe liczby z forów, wyliczasz bezpieczny limit procesów na podstawie realnego budżetu pamięci RAM swojego serwera.

Najczęściej zadawane pytania

Czy włączenie wyświetlania błędów WP_DEBUG_DISPLAY na żywej stronie sklepu jest bezpieczne?

Nie na produkcji — błędy wypisane na ekranie potrafią ujawnić ścieżki serwerowe i fragmenty zapytań; używaj WP_DEBUG_LOG, który po cichu zapisuje szczegóły do pliku niedostępnego publicznie.

Jak sprawdzić poprawność pliku konfiguracyjnego Nginx przed jego restartem?

Zawsze wykonaj najpierw komendę sudo nginx -t — jeśli w edytowanym pliku zabrakło średnika lub nawiasu klamrowego, narzędzie wskaże dokładną linię bez zatrzymywania działającego serwera.

Dlaczego błąd 504 Gateway Time-out pojawia się tylko podczas importu produktów z pliku XML?

Długotrwały import przekracza domyślny 60-sekundowy limit proxy (fastcgi_read_timeout / max_execution_time) — duże importy najlepiej uruchamiać z harmonogramu WP-CLI lub crona poza przeglądarką.

Dowiedz się więcej

Powiązane poradniki i wyjaśnienia do tego zadania

Skonfiguruj rekordy DNS SPF, DKIM i DMARC dla poczty we własnej domenie

Prześlij swoje obecne rekordy TXT strefy DNS, aby scalić wpisy SPF bez przekraczania limitu 10 odpytań, aktywować podpis DKIM i wdrożyć politykę DMARC wymaganą przez Gmail i Yahoo.

Skieruj domenę na serwer i wdróż automatyczny certyfikat SSL bez pętli przekierowań

Zmień rekordy A, AAAA i CNAME bez psucia działającej poczty firmowej (rekordów MX), wygeneruj darmowy certyfikat Let's Encrypt i usuń błąd Mixed Content.

Przenieś witrynę WordPress i bazę MySQL na nowy serwer bez przerwy w działaniu

Wykonaj bezpieczne przeniesienie plików i bazy danych, przetestuj stronę na nowym serwerze przez plik hosts przed zmianą DNS i uniknij rozsypania serializowanych danych.

Utwardź zabezpieczenia nowego serwera VPS z Linuxem, kluczami SSH i zaporą UFW

Przejdź bezpieczną procedurę pierwszego uruchomienia VPS: skonfiguruj logowanie wyłącznie kluczem Ed25519 bez odcięcia sobie dostępu, wyłącz hasło roota i włącz automatyczne aktualizacje.

Skonfiguruj skrzynkę firmową IMAP i SMTP w programie Outlook lub Thunderbird

Dobierz właściwe porty szyfrowane SSL/TLS (993 i 465/587), rozwiąż problem niezapisywania wysłanych wiadomości, hasła aplikacji oraz migracji ze starego protokołu POP3.

Sprawdź obecność serwera na czarnych listach RBL i popraw reputację poczty

Prześlij treść komunikatu zwrotnego Mailer-Daemon (np. Spamhaus, Barracuda, UCEPROTECT, Microsoft SNDS), aby namierzyć przyczynę blokady i skutecznie wypisać adres IP.