Что означает ошибка 502 Bad Gateway?

Веб-сервер Nginx работает в роли шлюза (Reverse Proxy): он принимает запрос из интернета и передает его обработчику PHP (службе PHP-FPM). Ошибка 502 Bad Gateway означает, что Nginx обратился к PHP-FPM, но тот либо упал, либо завис от перегрузки, либо недоступен по сокету/порту.

Пошаговый алгоритм устранения ошибки 502

1. Шаг 1: Проверяем статус службы PHP-FPM

   Узнайте версию установленного PHP и проверьте его статус (замените 8.2 на вашу версию):

   sudo systemctl status php8.2-fpm
   
   # Если служба остановлена, запускаем ее:
   sudo systemctl restart php8.2-fpm

2. Шаг 2: Читаем последние строки лога ошибок Nginx

   sudo tail -n 20 /var/log/nginx/error.log

3. Шаг 3: Сверяем путь к сокету в конфигурации

   Откройте файл виртуального хоста вашего сайта (например, /etc/nginx/sites-available/default) и проверьте блок fastcgi_pass:

   location ~ \.php$ {
       include snippets/fastcgi-php.conf;
       # Путь должен в точности совпадать с реальным файлом в /run/php/:
       fastcgi_pass unix:/run/php/php8.2-fpm.sock;
   }

   Проверьте синтаксис и перезапустите Nginx: sudo nginx -t && sudo systemctl restart nginx.

4. Шаг 4: Увеличиваем лимиты пула процессов при высокой нагрузке

   Если 502 ошибка появляется только при наплыве посетителей, откройте /etc/php/8.2/fpm/pool.d/www.conf и увеличьте количество воркеров:

   pm = dynamic
   pm.max_children = 50
   pm.start_servers = 10
   pm.min_spare_servers = 5
   pm.max_spare_servers = 20