Ошибка 502 Bad Gateway — одна из самых частых на сайтах: открываете страницу, а вместо неё белый экран с надписью «502 Bad Gateway» или «Ошибка 502». Разберёмся, что она означает, кто виноват — браузер, сайт или сервер, — и как её исправить: сначала для обычного посетителя, затем для владельца сайта на VPS.
Что означает ошибка 502
Код 502 значит, что сервер-посредник (шлюз или прокси) получил некорректный ответ от сервера, который стоит за ним. Чаще всего схема такая: запрос принимает веб-сервер Nginx, а саму страницу собирает приложение — PHP-FPM, Node.js, Python (Gunicorn, uWSGI) или Docker-контейнер. Если приложение упало, перегружено или не отвечает так, как ожидает Nginx, посетитель видит 502.
Важно: 502 — ошибка на стороне сайта, а не вашего компьютера. Но иногда её «помогают» вызвать кеш браузера, DNS или расширения.
Как выглядит ошибка
502 Bad Gatewayи строчкаnginxвнизу — классический вариант;HTTP Error 502 — Bad Gatewayв Chrome и Edge;- страница Cloudflare «Bad gateway Error code 502» — ошибка между Cloudflare и вашим сервером;
502 Proxy Error— если перед сайтом стоит Apache с mod_proxy.
Что делать посетителю сайта
- Обновите страницу через 30–60 секунд (Ctrl+F5 или Cmd+Shift+R). Часто 502 — короткий сбой при перезапуске сервера.
- Откройте сайт в режиме инкогнито или другом браузере — так вы исключите кеш и расширения.
- Очистите кеш и cookies для этого сайта.
- Сбросьте DNS-кеш: в Windows —
ipconfig /flushdns, в macOS —sudo dscacheutil -flushcache. - Отключите VPN или прокси и попробуйте снова: иногда ошибка возникает на промежуточном узле.
- Проверьте, работает ли сайт у других — через сервисы вроде downforeveryoneorjustme.com. Если не работает ни у кого — остаётся ждать, проблема у владельца.
Причины ошибки 502 на сервере
| Причина | Как проявляется |
|---|---|
| Упал или не запущен бэкенд (PHP-FPM, Node.js, Gunicorn) | 502 на всех страницах сразу |
| Не хватает памяти, процесс убил OOM killer | 502 появляется под нагрузкой и пропадает после перезапуска |
Исчерпан лимит воркеров PHP-FPM (pm.max_children) |
502 в часы пик, в логе «server reached pm.max_children» |
| Неверный адрес бэкенда в конфиге Nginx (порт, сокет) | 502 сразу после изменения настроек |
| Слишком маленькие буферы для заголовков ответа | «upstream sent too big header» в error.log |
| Firewall или SELinux блокирует соединение Nginx с бэкендом | «Permission denied» / «connection refused» в логе |
| Cloudflare не может достучаться до сервера | страница Cloudflare с кодом 502 |
Как исправить 502 Bad Gateway: пошагово для владельца сайта
Шаг 1. Посмотрите лог Nginx
Подключитесь к серверу по SSH и откройте журнал ошибок — в нём почти всегда написана причина:
sudo tail -n 50 /var/log/nginx/error.log
Типичные строки: connect() failed (111: Connection refused) while connecting to upstream — бэкенд не запущен; upstream prematurely closed connection — бэкенд упал во время ответа; upstream sent too big header — нужны буферы побольше.
Шаг 2. Проверьте, запущен ли бэкенд
sudo systemctl status php8.3-fpm
sudo systemctl restart php8.3-fpm
# для Node.js под pm2:
pm2 status
pm2 restart all
# для Docker:
docker ps -a
Если сервис не стартует, смотрите его собственный лог: journalctl -u php8.3-fpm -n 50.
Шаг 3. Сверьте адрес бэкенда в конфиге
В блоке сайта адрес в fastcgi_pass или proxy_pass должен совпадать с тем, где реально слушает приложение:
# PHP-FPM через сокет
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
# приложение на порту
proxy_pass http://127.0.0.1:3000;
После правки проверьте синтаксис и перезагрузите Nginx: sudo nginx -t && sudo systemctl reload nginx.
Шаг 4. Проверьте память и нагрузку
free -h
dmesg -T | grep -i "killed process"
htop
Если процессы убивает OOM killer или память постоянно на нуле, сайту не хватает ресурсов. Варианты: уменьшить pm.max_children, добавить swap, оптимизировать запросы к базе — или перейти на тариф VPS с большим объёмом RAM.
Шаг 5. Увеличьте буферы и таймауты при необходимости
fastcgi_buffers 16 16k;
fastcgi_buffer_size 32k;
proxy_buffer_size 16k;
proxy_read_timeout 120s;
Шаг 6. Если сайт за Cloudflare
Проверьте, открывается ли сайт напрямую по IP сервера. Если напрямую всё работает, а через Cloudflare — нет, убедитесь, что firewall на сервере не блокирует IP-адреса Cloudflare, а режим SSL в панели Cloudflare соответствует настройкам сервера (Full / Full strict при установленном сертификате).
Чем 502 отличается от 500, 503, 504 и 524
| Код | Что значит | Где искать |
|---|---|---|
| 500 | Ошибка внутри самого приложения | логи PHP / приложения |
| 502 | Шлюз получил некорректный ответ от бэкенда | error.log Nginx, статус бэкенда |
| 503 | Сервис временно недоступен, перегрузка или обслуживание | нагрузка, лимиты, режим обслуживания |
| 504 | Бэкенд не ответил вовремя | таймауты, медленные запросы |
| 524 | Cloudflare не дождался ответа сервера (100 секунд) | долгие скрипты, нагрузка на сервер |
Как не допускать ошибку 502
- Настройте автоперезапуск сервисов:
Restart=alwaysв systemd или pm2 для Node.js. - Подключите мониторинг доступности сайта и уведомления в Telegram.
- Оставляйте запас по памяти — не меньше 20–30% свободной RAM в обычном режиме.
- Проверяйте конфиг командой
nginx -tперед каждым перезапуском. - Для нагруженных проектов выбирайте сервер с высокой частотой процессора: PHP и Node.js обрабатывают запрос в одном потоке, и частота ядра напрямую влияет на скорость ответа.
Если 502 появляется из-за нехватки ресурсов, проще всего перенести сайт на сервер с запасом: VPS PSB Hosting — NVMe-диски и безлимитный трафик, а для тяжёлых сайтов — Hi-CPU VPS на Ryzen 9 7950X.
Частые вопросы
Ошибка 502 — это проблема у меня или у сайта?
Почти всегда у сайта. Если сайт не открывается и в другом браузере, и с телефона через мобильный интернет, остаётся подождать или написать владельцу.
Сколько обычно длится ошибка 502?
Если это перезапуск сервера — от нескольких секунд до пары минут. Если упало приложение и его никто не перезапустил — пока владелец не исправит.
Влияет ли ошибка 502 на SEO?
Кратковременная — нет. Если поисковый робот несколько дней подряд получает 502, страницы могут выпасть из индекса, поэтому важно настроить мониторинг.
Как исправить 502 на WordPress?
Отключите недавно установленные плагины (переименуйте папку плагина через SFTP), перезапустите PHP-FPM и проверьте лимит памяти PHP. Чаще всего виноват плагин или нехватка воркеров PHP-FPM.









