⏱️
Хостинг

504 Gateway Timeout: причины ошибки и пошаговое исправление

17.11.2026
← Все статьи

Увидев в браузере «504 Gateway Timeout», многие думают, что сайт полностью сломался. На деле ошибка говорит о вполне конкретной вещи: стоящий впереди сервер (обычно Nginx) передал запрос приложению, но не получил ответ за отведённое время. То есть приложение может работать, просто слишком медленно. Понимание этой разницы — первый шаг к правильному решению, потому что исправление 504 чаще требует правки кода или базы данных, а не сервера.

Чем 504 отличается от 502

Обе ошибки связаны со шлюзом, то есть с промежуточным сервером, но означают разное. 502 Bad Gateway возникает, когда приложение вернуло некорректный ответ или вовсе не приняло соединение: например, упал PHP-FPM или процесс Node.js. 504 — это ситуация, когда соединение установлено, запрос отправлен, но время ожидания истекло раньше, чем пришёл ответ. Проще говоря, 502 — «никто не ответил», а 504 — «ответ слишком затянулся».

Самые частые причины

На практике большинство ошибок 504 вызвано несколькими типичными ситуациями. Знание их сильно ускоряет чтение логов:

Ищем причину в логах

Вместо догадок сначала нужно открыть журнал ошибок Nginx. На VPS это обычно /var/log/nginx/error.log. При 504 там будет запись примерно такого вида:

upstream timed out (110: Connection timed out) while reading response header from upstream,
client: 203.0.113.25, server: example.uz, request: "POST /admin/import HTTP/1.1",
upstream: "fastcgi://unix:/run/php/php8.2-fpm.sock"

Из неё видно, какой адрес работает медленно (request) и какой бэкенд не ответил (upstream). Если ошибка появляется только на одной странице, проблема в её коде. Если по всему сайту, скорее всего, закончился общий ресурс: база данных или воркеры PHP-FPM.

Следующий шаг — база данных. Посмотреть выполняющиеся сейчас запросы в MySQL или MariaDB можно командой ниже. Главные подозреваемые — запросы с большим значением в колонке Time:

mysql -u root -p -e "SHOW FULL PROCESSLIST;"

Для постоянного наблюдения полезно включить журнал медленных запросов. Он записывает каждый запрос дольше заданного порога и подсказывает, каким таблицам нужен индекс:

SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 2;

Где задаются лимиты времени

На пути запроса несколько уровней, и у каждого свой таймаут. Срабатывает самый короткий, поэтому если увеличить один и забыть про другой, ошибка вернётся в другом виде.

УровеньПараметрНазначение
Nginx (proxy)proxy_read_timeoutОжидание ответа от Node.js, Python или другого HTTP-бэкенда
Nginx (PHP)fastcgi_read_timeoutОжидание ответа от PHP-FPM
PHPmax_execution_timeЛимит времени выполнения скрипта
PHP-FPMrequest_terminate_timeoutПринудительная остановка запроса на уровне пула

Оба параметра Nginx по умолчанию равны 60 секундам. Для конкретного адреса, который действительно должен работать долго, их правильно увеличивать только внутри его location:

location = /admin/import.php {
    fastcgi_read_timeout 300s;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

А вот поднимать таймаут до нескольких минут для всего сайта опасно: медленные запросы дольше держат воркеры, и при высоком трафике сайт ляжет ещё быстрее.

Пример: сайт школы в Андижане и выгрузка оценок

На сайте частной школы в Андижане учителя в конце четверти выгружают оценки всех классов в один Excel-файл. Сначала всё работало, но с ростом числа учеников кнопка выгрузки начала возвращать 504. В логе нашлись адрес /teacher/export и запись upstream timed out, а в журнале медленных запросов — поиск без индекса по таблице оценок. После добавления индекса на колонки student_id и quarter запрос стал выполняться за секунды. Позже выгрузку перенесли в фоновую задачу: учитель нажимает кнопку, а когда файл готов, появляется ссылка на скачивание.

Правильный порядок действий

  1. Найдите медленное место. По логу Nginx, журналу медленных запросов и логам приложения определите, какой именно запрос и какая операция занимает время.
  2. Ускорьте запрос. Добавьте индекс, не загружайте лишние данные, кешируйте результат. Часто одного этого шага достаточно.
  3. Ставьте короткий таймаут для внешних API. Не ждите внешний сервис бесконечно: задайте, например, CURLOPT_TIMEOUT в cURL и верните пользователю понятную ошибку.
  4. Выносите тяжёлую работу в фон. Импорт, экспорт, массовые рассылки выполняйте через очередь и cron.
  5. Только после этого увеличивайте таймаут, и только для тех адресов, которые действительно должны работать долго.

Что можно сделать на виртуальном хостинге

На виртуальном хостинге настройки Nginx и PHP-FPM находятся в руках администратора сервера, но многое можно проверить самостоятельно. В панели ISPmanager, в которую вы входите из кабинета sayt.uz, доступны логи ошибок сайта, выбор версии PHP и часть параметров. На сайтах WordPress ошибка 504 часто связана с одним тяжёлым плагином, расширением для резервного копирования или неправильно настроенной cron-задачей, поэтому полезно временно отключить недавно установленные плагины. Если причина на уровне сервера или в логах не удаётся найти ответ, создайте тикет в техподдержку с указанием времени и адреса, где возникла ошибка: это заметно ускорит проверку.

Похожие статьи

💾 Swap на VPS: нужен ли, какого размера и как настроить 🗂️ Файловый менеджер ISPmanager: загрузка, архивы, редактирование и права 📜 SLA хостинга: гарантии, процент аптайма и компенсация 📚 Хостинг для научного журнала на OJS: требования и правильная настройка
🌐 Язык
🇺🇿 O'zbek 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English