ВЕРНУТЬСЯ

БАЗА ЗНАНИЙ

Ошибка 504 Gateway Time-out: причины и как исправить

Что означает ошибка 504 Gateway Time-out и как её исправить: кто её выдаёт, чей таймаут истёк, что проверить посетителю и владельцу сайта, где смотреть логи и какие лимиты хостинга её вызывают.

Ошибка 504 Gateway Time-out: причины и как исправить

Ошибка 504 означает, что сервер не ответил вовремя. Её показывает не сам сайт, а узел перед ним: веб-сервер, прокси или CDN. Поэтому искать причину приходится не там, где кажется на первый взгляд. Ниже разберём, чей именно таймаут истёк, что может сделать посетитель, что владелец сайта, где смотреть логи и почему на дешёвом тарифе такая ошибка появляется чаще.

Что означает ошибка 504

Полное название — 504 Gateway Time-out, по-русски «тайм-аут шлюза». В панелях и браузерах формулировка бывает другой: «время ответа сервера истекло», «сервер не отвечает», «превышено время ожидания». Это одно и то же состояние.

Шлюз здесь — промежуточный узел. Он принял запрос, передал его обработчику и не получил ответ за отведённое время, после чего сообщил об этом посетителю.

Код начинается с пятёрки, значит проблема на стороне сервера: браузер, интернет и настройки устройства посетителя здесь ни при чём. Этим 504 и отличается от ситуации, когда сайт не открывается вообще. Соединение установилось, имя домена разрешилось в адрес, запрос дошёл до сервера — иначе вместо аккуратной страницы с кодом посетитель увидел бы сообщение о недоступности узла. Если вы видите http 504, сеть и DNS свою работу уже сделали, и разбираться нужно внутри сервера.

Где именно рвётся путь запроса и чей таймаут истёк

Между браузером и базой данных стоит несколько узлов, и у каждого свой запас терпения.

Схема пути запроса: браузер, CDN, веб-сервер Nginx, обработчик php-fpm, база данных, с таймаутом на каждом узле
Ошибку отдаёт тот узел, чьё терпение закончилось первым

Браузер обращается к CDN, если сайт за ним спрятан, CDN передаёт запрос веб-серверу, обычно это Nginx — как он устроен, разобрано в статье что такое Nginx. Страницы Nginx не считает: он отдаёт запрос обработчику PHP, а тот обращается к базе данных. Ответ возвращается обратно по той же цепочке.

Узел Параметр ожидания Обычное значение Что делает при истечении
CDN (Cloudflare) внутренний таймаут 100 с отдаёт свой код 524
Прокси или балансировщик proxy_read_timeout 60 с отдаёт 504
Nginx перед PHP fastcgi_read_timeout 60 с отдаёт 504
Обработчик php-fpm request_terminate_timeout 60–180 с убивает процесс, посетитель получает 502
PHP max_execution_time 30–180 с прерывает скрипт, страница отдаётся с кодом 500
MySQL wait_timeout 28 800 с закрывает простаивающее соединение

Время на скрипт и время ожидания ответа — два разных лимита, и живут они в разных местах. Ошибку 504 отдаёт второй: веб-сервер перестал ждать. Когда PHP успевает прервать скрипт сам, посетитель получает пустую страницу или код 500.

Поэтому тариф может обещать 90 секунд на скрипт, а посетитель получит ошибку 504 на шестидесятой: веб-сервер готов ждать только минуту. Из-за этого строка «ошибка 504 время ответа сервера истекло» в логе и настройка времени выполнения в панели часто показывают разные числа.

Что делать посетителю сайта

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

Советы из интернета здесь в основном бесполезны. Кеш браузера чистить незачем: ошибку сформировал сервер. Менять DNS-серверы и перезагружать роутер тоже смысла нет — имя домена уже разрешилось в адрес.

Если страница нужна срочно, напишите владельцу сайта или в поддержку сервиса: со стороны посетителя ошибка 504 на сайте не исправляется.

Виноват сайт или канал связи

Владельцу сайта первым делом нужно сузить область поиска. Четыре проверки занимают несколько минут.

Три варианта страницы ошибки: типовая страница Nginx, страница CDN с кодом 524, страница хостинг-провайдера
По оформлению страницы ошибки видно, какой узел её выдал

Посмотрите, кто отдал страницу. Строгая надпись «504 Gateway Time-out» с подписью nginx внизу — это веб-сервер. Страница с логотипом CDN и кодом 524 говорит, что до сервера запрос не дошёл. Фирменная заглушка провайдера означает, что отвечает его балансировщик.

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

Откройте сайт по IP-адресу сервера, минуя домен. Так вы поймёте, что означает ошибка 504 на сайте в вашем случае: сервер жив, но не успевает, или дело в маршруте до него.

Убедитесь, что домен ведёт на тот сервер, который вы чините. После переезда это самая частая ошибка: правки вносят на новом сервере, а посетители идут на старый. Как проверить, куда смотрит домен, описано в статье что такое DNS.

Девять причин ошибки 504 и как их отличить

Причина почти всегда одна из девяти, и отличают их по обстоятельствам: на каких страницах ошибка появляется и в какое время.

Девять причин ошибки 504, сгруппированные по источнику: код сайта, нагрузка, внешние сервисы, настройки
Четыре группы причин: код сайта, нагрузка, внешние сервисы и настройки
Когда появляется Причина Что проверить
На одной странице, остальные быстрые долгий скрипт slowlog обработчика: он покажет, где скрипт застрял
В часы пик, по вечерам не хватает обработчиков, запросы встают в очередь число одновременных запросов в тарифе
Сразу после запуска импорта или пересчёта длинная операция идёт через браузер чем занят сайт в момент ошибки
Только на страницах с внешними данными сторонний сервис не отвечает таймаут исходящих запросов в коде
Вместе с медленной админкой тяжёлые запросы к базе лог медленных запросов, план запроса через EXPLAIN
Внезапно и на всём сайте рост нагрузки или атака лог доступа: сколько запросов и с каких адресов
Сразу после правки конфигурации неверный адрес обработчика или сокета nginx -t и блок upstream
Посетитель видит 524, а не 504 CDN ждёт меньше, чем работает сайт настройки таймаута у CDN
После переезда на новый сервер домен ведёт на старый адрес A-запись домена

Резкий рост запросов даёт одинаковую картину и при наплыве посетителей, и при атаке, когда сервер занят мусорным трафиком. Как отличить одно от другого, разобрано в статье что такое DDoS-атака.

Лимиты хостинга: сколько времени тариф даёт скрипту

На общем хостинге сайт живёт не один, и ресурсы между аккаунтами разделены. Делается это пулом обработчиков: сайту выделено столько процессов, сколько указано в тарифе как число одновременных запросов. Пока все заняты, следующий запрос ждёт в очереди, и если он прождёт дольше таймаута веб-сервера, посетитель получит 504.

Четыре тарифа хостинга ZION с временем на скрипт 60, 90, 120 и 180 секунд и числом одновременных запросов 5, 10, 20 и 30
Чем выше тариф, тем больше одновременных запросов и времени на скрипт

В ZION эти границы опубликованы в тарифах, так что их видно до покупки.

Тариф Время на скрипт Память на запрос Одновременных запросов SSH Цена за месяц
Старт 60 с 256 МБ 5 нет 199 ₽
Проект 90 с 384 МБ 10 есть 399 ₽
Бизнес 120 с 512 МБ 20 есть 790 ₽
Студия 180 с 768 МБ 30 есть 1290 ₽

Такие лимиты есть у любого провайдера, просто не все их публикуют. Ограничение времени защищает соседние сайты от одного зависшего скрипта, поэтому совсем без него хостинга не бывает. Зато по таблице видно, в какой именно лимит вы упёрлись: магазин с импортом каталога на «Старте» будет ловить таймауты регулярно, а на «Студии» та же выгрузка уложится в отведённое время. Что такое общий хостинг и откуда берутся эти рамки, объясняет статья что такое хостинг простыми словами.

СЕРВЕР ПОД ВАШИ ЗАДАЧИ БЫСТРО И БЕЗ ЛИШНИХ СЛОЖНОСТЕЙ

Подберите конфигурацию, оплатите и начните работу за несколько минут — без сложной настройки

Где смотреть логи и что в них искать

Диагностика начинается с одной строки в журнале ошибок веб-сервера.

Разбор строки лога Nginx: время, адрес клиента, сообщение upstream timed out, адрес обработчика и запрошенный URL
В одной строке есть всё: когда, по какому адресу и какой обработчик не ответил
2026/11/18 14:22:07 [error] 2841#0: *17 upstream timed out
(110: Connection timed out) while reading response header from upstream,
client: 203.0.113.25, server: example.ru,
request: "GET /catalog/export HTTP/1.1",
upstream: "fastcgi://unix:/var/run/php-fpm/example.sock"

upstream timed out подтверждает, что обработчик был жив и просто не успел: при падении запись была бы другой. Поле request называет страницу, которая не отработала, — по нему сразу понятно, какой код смотреть. Время в начале строки сравните с временем жалобы посетителя.

Второй источник — slowlog обработчика PHP. С параметром request_slowlog_timeout php-fpm сбрасывает в файл стек зависшего скрипта с именами функций и номерами строк: это самый короткий путь к участку кода, который висит.

Третий — лог медленных запросов базы. Порог задаёт long_query_time, и всё, что длиннее, попадает в файл. Чаще всего там находится выборка без индекса по таблице заказов.

Читать журналы удобнее с сервера по SSH: как подключиться, описано в статье что такое SSH. Но на дешёвых тарифах доступа к консоли нет — в ZION он открыт начиная с «Проекта». Без SSH логи сайта доступны через панель: в ispmanager 6 они лежат в журналах сайта, а сами файлы видно в менеджере файлов. Если нужного файла там нет, его присылает поддержка по запросу.

Как исправить на своём сервере

Первое желание — поднять таймаут. В Nginx это fastcgi_read_timeout для PHP и proxy_read_timeout для проксируемых приложений:

location ~ \.php$ {
    fastcgi_pass unix:/var/run/php-fpm/example.sock;
    fastcgi_read_timeout 180s;
}

После правки проверьте конфигурацию и перечитайте её без остановки сервера:

nginx -t && systemctl reload nginx

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

Дальше лечится сама медлительность. Тяжёлый запрос к базе разбирают через EXPLAIN и закрывают индексом: на таблице в сотни тысяч строк это даёт разницу в десятки раз. Страницы, которые пересчитываются при каждом открытии, уводят в кеш. Исходящим запросам к сторонним сервисам задают свой таймаут в три-пять секунд, иначе чужая недоступность превращается в вашу ошибку 504.

Если причина не в коде, а в том, что сайту тесно, помогает переход на отдельный сервер: там и обработчиков больше, и таймауты настраиваются под себя. Чем VPS отличается от общего хостинга, разобрано в статье что такое VPS.

Долгие операции в CMS

Самая частая причина таймаутов у магазинов — операции, которые запускают кнопкой в админке.

Сравнение двух способов запуска длинной операции: через браузер с таймаутом и через планировщик cron без ограничения времени
Операция, запущенная планировщиком, не зависит от терпения веб-сервера

Импорт каталога на десять тысяч товаров, пересчёт цен и скидок, обмен с 1С, поиск и замена по базе, пересборка кеша, обновление миграций — любая из этих задач легко выходит за минуту. Через браузер она выполняется в том же процессе, который обслуживает обычные страницы, и попадает под тот же таймаут.

Операцию длиннее минуты через браузер не запускают: для этого есть планировщик и консоль, где ограничения на время выполнения нет. В тарифах ZION число заданий cron указано там же, где остальные лимиты: от пяти на «Старте» до шестидесяти на «Студии».

У WordPress для этого есть wp-cli, у Битрикса консольные скрипты, в самописных проектах пишут команду для cron. Если запуска из консоли нет, операцию делят на порции: импорт по пятьсот товаров за проход с сохранением позиции.

Чем 504 отличается от 502, 503, 408 и 524

Эти коды приходят от одних и тех же узлов, а означают разное, и лечатся тоже по-разному.

Шпаргалка по кодам 504, 502, 503, 408 и 524 с коротким описанием каждого
Пять похожих кодов и что каждый из них на самом деле означает
Код Что произошло Кто отдаёт С чего начинать
504 обработчик не ответил вовремя веб-сервер или прокси искать, что именно работает долго
502 обработчик не ответил вообще или ответил неразборчиво веб-сервер или прокси проверить, жив ли php-fpm и верен ли сокет
503 сервер жив, но обслуживать отказывается: перегрузка или техработы сам сервер приложения посмотреть нагрузку и заголовок Retry-After
408 клиент не дослал запрос за отведённое время веб-сервер смотреть на канал клиента, а не на сервер
524 тот же таймаут, но зафиксированный CDN Cloudflare сравнить лимит CDN со временем ответа сайта

Иногда на одном сайте за день приходит и 502, и 504 ошибка. Обычно это значит, что обработчик сначала долго думал, а потом был убит по своему лимиту: до какого-то момента приходил таймаут, дальше пошёл обрыв.

Код 524 стоит запомнить отдельно: Cloudflare ждёт сто секунд и показывает свою страницу. Сайт при этом может быть настроен на три минуты работы скрипта, и в его логах никакой ошибки не окажется.

Как 504 влияет на поиск

Поисковые системы относятся к пятисотым кодам как к временной неполадке. Один-два случая ничего не меняют: робот вернётся позже и получит страницу.

Затяжная история выглядит иначе. Когда ошибки повторяются неделями, робот снижает частоту обхода, новые страницы попадают в индекс медленнее, а те, что давно не удалось получить, со временем выпадают. Отслеживать это удобно в Яндекс.Вебмастере: в разделе диагностики видно, сколько ответов сервера оказались ошибочными и когда. В Search Console есть похожий отчёт.

На время плановых работ не отдавайте 404, иначе робот решит, что страницы удалены. Правильный ответ при остановке сайта — 503 с заголовком Retry-After: он прямо говорит, когда возвращаться.

Профилактика: как не допускать 504

Чек-лист владельца сайта: мониторинг доступности, профилирование страниц, таймауты на внешние запросы, долгие операции по расписанию, запас по тарифу
Пять привычек, которые закрывают большинство причин таймаута

Поставьте мониторинг доступности с уведомлением в мессенджер: разница между «узнал через минуту» и «узнал от клиента на следующий день» измеряется заказами. Следите заодно за временем ответа страниц, а не только за самим фактом доступности. Страница, которая отвечает двадцать секунд, до таймаута пока не доросла, но стоит от него в одном шаге.

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

Частые вопросы

Промежуточный узел передал запрос дальше и не дождался ответа. Сайт при этом существует и доступен по сети, он просто не успел подготовить страницу за отведённое время.
У сайта. Код ответа начинается с пятёрки, то есть сформирован сервером. Проверить просто: откройте любой другой сайт — если он работает, ваш канал в порядке.
Вы попадаете в момент, когда все обработчики заняты или когда идёт тяжёлая операция. Такие ошибки привязаны к часам пик и к запуску выгрузок.
На время это работает, но причина остаётся, и посетитель просто ждёт дольше. Параллельно стоит найти, что отвечает медленно.
Разовый таймаут проходит за минуты, как только сервер освободится. Если ошибка держится часами, сама она не исчезнет: значит, зависший процесс или перегруженная база остаются на месте.
При 504 обработчик не ответил вовремя, при 502 не ответил вообще или ответил неразборчиво. В первом случае ищут, что работает долго, во втором проверяют, жив ли сам обработчик.
Единичные ошибки не влияют. Если они повторяются неделями, робот сокращает обход, и страницы начинают медленнее попадать в индекс.
Через панель управления: журналы сайта доступны в ispmanager 6, а файлы логов видно в менеджере файлов. Если нужного журнала нет, его выдаёт поддержка по запросу.
Поможет, если сайту тесно в лимитах общего хостинга: на своём сервере больше обработчиков и настраиваемые таймауты. Если причина в запросе без индекса, она переедет вместе с сайтом.