Увидев в браузере «504 Gateway Timeout», многие думают, что сайт полностью сломался. На деле ошибка говорит о вполне конкретной вещи: стоящий впереди сервер (обычно Nginx) передал запрос приложению, но не получил ответ за отведённое время. То есть приложение может работать, просто слишком медленно. Понимание этой разницы — первый шаг к правильному решению, потому что исправление 504 чаще требует правки кода или базы данных, а не сервера.
Чем 504 отличается от 502
Обе ошибки связаны со шлюзом, то есть с промежуточным сервером, но означают разное. 502 Bad Gateway возникает, когда приложение вернуло некорректный ответ или вовсе не приняло соединение: например, упал PHP-FPM или процесс Node.js. 504 — это ситуация, когда соединение установлено, запрос отправлен, но время ожидания истекло раньше, чем пришёл ответ. Проще говоря, 502 — «никто не ответил», а 504 — «ответ слишком затянулся».
Самые частые причины
На практике большинство ошибок 504 вызвано несколькими типичными ситуациями. Знание их сильно ускоряет чтение логов:
- Медленные SQL-запросы. Поиск по большой таблице без индекса, объединение десятков тысяч строк или заблокированная таблица могут задержать страницу на минуты.
- Ожидание внешних сервисов. Если не отвечает платёжная система, SMS-шлюз, сервис курсов валют или API доставки, ваш скрипт тоже зависает в ожидании.
- Тяжёлая работа внутри запроса. Импорт большого Excel-файла, пересжатие сотен изображений, генерация PDF-отчёта или массовая рассылка прямо в браузерном запросе легко упираются в лимит времени.
- Занятые воркеры PHP-FPM. Когда все рабочие процессы заняты медленными запросами, новые встают в очередь и в итоге отваливаются по таймауту. Часто это сопровождает бот-атаку или резкий рост трафика.
- Исчерпание ресурсов сервера. При нехватке памяти система уходит в swap или убивает процессы, а при перегруженном диске замедляется каждая операция.
Ищем причину в логах
Вместо догадок сначала нужно открыть журнал ошибок 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 |
| PHP | max_execution_time | Лимит времени выполнения скрипта |
| PHP-FPM | request_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 запрос стал выполняться за секунды. Позже выгрузку перенесли в фоновую задачу: учитель нажимает кнопку, а когда файл готов, появляется ссылка на скачивание.
Правильный порядок действий
- Найдите медленное место. По логу Nginx, журналу медленных запросов и логам приложения определите, какой именно запрос и какая операция занимает время.
- Ускорьте запрос. Добавьте индекс, не загружайте лишние данные, кешируйте результат. Часто одного этого шага достаточно.
- Ставьте короткий таймаут для внешних API. Не ждите внешний сервис бесконечно: задайте, например,
CURLOPT_TIMEOUTв cURL и верните пользователю понятную ошибку. - Выносите тяжёлую работу в фон. Импорт, экспорт, массовые рассылки выполняйте через очередь и cron.
- Только после этого увеличивайте таймаут, и только для тех адресов, которые действительно должны работать долго.
Что можно сделать на виртуальном хостинге
На виртуальном хостинге настройки Nginx и PHP-FPM находятся в руках администратора сервера, но многое можно проверить самостоятельно. В панели ISPmanager, в которую вы входите из кабинета sayt.uz, доступны логи ошибок сайта, выбор версии PHP и часть параметров. На сайтах WordPress ошибка 504 часто связана с одним тяжёлым плагином, расширением для резервного копирования или неправильно настроенной cron-задачей, поэтому полезно временно отключить недавно установленные плагины. Если причина на уровне сервера или в логах не удаётся найти ответ, создайте тикет в техподдержку с указанием времени и адреса, где возникла ошибка: это заметно ускорит проверку.