Loading...

HTTP-ошибки

504 Gateway Timeout: кто ждал, сколько и как это исправить

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

9 мин чтения Средний Обновлено

504 Gateway Timeout: кто ждал, сколько и как это исправить

Что на самом деле означает 504

Шлюз — это всё, что принимает запрос и передаёт его дальше: edge-сервер CDN, балансировщик, nginx перед PHP-FPM или Node. 504 Gateway Timeout — это шлюз говорит: я дошёл до сервера за мной, задал вопрос, а ответ не пришёл до истечения моего лимита.

Этим 504 отличается от соседей. 502 Bad Gateway означает, что ответ был непригоден или соединение не удалось. 503 Service Unavailable означает, что запрос намеренно отклонили. А 504 значит, что никто ничего не отклонял: запрос принят и вполне может продолжать выполняться на вашем сервере, когда посетитель уже увидел ошибку.

На практике это важно. 504 не отменяет работу: отчёт, который «упал» по тайм-ауту на прокси, может завершиться на origin минутой позже, а посетитель, нажавший кнопку ещё раз, запускает вторую копию.

Кто кого ждал

Типичный запрос проходит через несколько точек ожидания: посетитель → edge-сервер CDN → ваш веб-сервер (nginx или Apache) → ваше приложение (PHP-FPM, Node, контейнер) → ваша база данных или внешний API. Каждая стрелка — это шлюз со своим тайм-аутом, и настраиваются они независимо, часто разными людьми.

Правило, которое экономит больше всего времени: срабатывает самый короткий тайм-аут в цепочке. Если edge ждёт 60 секунд, ваш nginx ждёт PHP-FPM 60 секунд, а PHP останавливает скрипт через 30, запрос так и не подойдёт к лимиту edge: PHP завершит его на 30-й секунде, а вышестоящее звено сообщит об ошибке.

Поэтому первый вопрос не «почему CDN выдаёт тайм-аут», а сколько времени прошло до появления ошибки? 504 ровно на 60-й секунде указывает на лимит в 60 секунд, на 30-й — на лимит в 30 секунд. Сравните это число с известными вам лимитами, и звено, которое сдалось, обычно называет себя само.

Причины почти любой ошибки 504

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

Работа, долгая по своей природе. Экспорт в CSV и Excel, PDF-отчёты, массовый импорт, обработка изображений или видео, бэкап, запущенный со страницы администратора. Это не баги, а задачи, которым не место внутри веб-запроса.

Внешний вызов без тайм-аута. Платёжный провайдер, API доставки, поисковый сервис. Когда он зависает, зависает и ваш запрос, и ваши посетители пережидают чужую аварию.

Перегруженный origin. Когда заняты все воркеры или потоки PHP-FPM, новые запросы стоят в очереди ещё до начала обработки. Каждый запрос может быть быстрым; время на ожидание в очереди и съедает лимит. Такие 504 группируются в часы пик.

Проблемы с сетью между звеньями. Файрвол, который молча отбрасывает пакеты вместо того, чтобы отклонять их, заставляет прокси ждать соединения, которое никогда не откроется. В итоге получается 504, а не быстрый отказ.

Диагностика: измерьте, куда уходит время

Замерьте запрос через CDN, а затем тот же запрос напрямую к вашему origin. curl умеет разбивать время по фазам, как в командах ниже.

Если connect большой или соединение вообще не устанавливается, проблема в доступе к origin: файрвол, маршрутизация, сервер не работает. Если connect быстрый, а ttfb (время до первого байта) большое, origin принял запрос и всё ещё работает над ним — это классический 504, и ответ нужно искать в вашем приложении.

Вторая команда обходит CDN через --resolve и по-прежнему отправляет ваше имя хоста. Если один только origin тоже отвечает 70 секунд, edge сообщает правду. Если напрямую он отвечает за две секунды, а через CDN упирается в тайм-аут, ищите отличие: правило файрвола, другой бэкенд для этого имени хоста или заголовки, которые ваше приложение обрабатывает иначе.

Затем прочитайте собственные логи origin за этот момент. В nginx добавьте $request_time и $upstream_response_time в формат лога; в Apache — %D. Включите журнал медленных запросов вашей базы данных и, для PHP, slowlog PHP-FPM, который записывает трассировку стека каждого слишком долгого запроса — обычно это самый быстрый путь к нужной строке.

Замер запроса через CDN и напрямую к origin

# through the CDN
curl -o /dev/null -s -w 'connect=%{time_connect}s tls=%{time_appconnect}s ttfb=%{time_starttransfer}s total=%{time_total}s code=%{http_code}\n' \
  https://www.example.com/reports/export

# straight to the origin, same hostname
curl -o /dev/null -s -w 'connect=%{time_connect}s ttfb=%{time_starttransfer}s total=%{time_total}s code=%{http_code}\n' \
  --resolve www.example.com:443:ORIGIN_IP https://www.example.com/reports/export

Сначала исправьте медленное место

Увеличение тайм-аута убирает ошибку, но посетитель ждёт ровно столько же. Прежде чем трогать любой лимит, сделайте запрос короче.

Индексы и кэш. Найдите медленный запрос в журнале медленных запросов и добавьте нужный ему индекс. Кэшируйте результаты, общие для многих посетителей, — в приложении или на edge с помощью заголовков Cache-Control.

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

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

Рассчитайте origin на пик. Если 504 группируются в загруженные часы, добавьте воркеры (pm.max_children в PHP-FPM, процессы Node, реплики контейнера) и пусть кэш на edge принимает повторные запросы, чтобы до origin доходило меньше из них.

Увеличивайте тайм-аут только там, где это нужно

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

На cdn.com.tr это настройка правила доставки: Тайм-аут ответа источника (секунды), от 1 до 3 600 секунд для каждого правила, по умолчанию 60 секунд. Создайте отдельное правило для нужного пути, например /admin/export/, и задайте более длинный тайм-аут только ему. Остальной сайт сохраняет короткое значение по умолчанию и по-прежнему быстро отказывает, когда что-то действительно сломано. На домене приложения Managed Container по умолчанию действует 300 секунд, если правило не задаёт другое значение.

Тайм-аут отсчитывает время между двумя порциями данных от вашего origin, а не общую длительность запроса. Пока данные идут, edge держит запрос открытым. Поэтому потоковый ответ — CSV, записываемый построчно, лента прогресса — может идти много минут, а скрипт, который пять минут считает и затем выводит всё сразу, — нет.

После этого выровняйте звенья за edge: proxy_read_timeout или fastcgi_read_timeout в nginx, max_execution_time в PHP, собственный лимит вашего сервера приложений. Длинный путь не длиннее самого короткого своего лимита.

Когда перед сайтом стоит CDN

CDN меняет цену 504 для вас.

Кэшированные страницы продолжают отдаваться. В правиле с кэшированием, если origin упёрся в тайм-аут, а у edge ещё есть копия страницы — даже просроченная, — edge отдаёт эту копию вместо ошибки. Медленная минута на origin превращается в слегка устаревшую страницу, а не в сломанную. Это веский повод кэшировать всё, что можно, с TTL, соответствующим тому, как часто контент действительно меняется.

Медленные пути становятся заметны. Когда 504 появляются только на /search или /checkout — некэшируемых динамических путях, — вы точно знаете, где искать.

Долгоживущие соединения подчиняются тому же правилу. Соединение WebSocket, по которому ничего не передаётся дольше тайм-аута, закрывается. Вынесите путь WebSocket в отдельное правило с включённой опцией Разрешить подключения WebSocket и подходящим тайм-аутом либо отправляйте небольшое сообщение-heartbeat чаще, чем истекает лимит. Обе настройки показаны в руководстве по подключению к источнику.

Как настроить

Пошаговые руководства в справочном центре:

504 Gateway Timeout: частые вопросы

Ошибка 504 — вина моего сервера или CDN?

В большинстве случаев время уходит на вашем origin, а edge — тот, кто ждал. Сравните запрос через CDN с прямым запросом к origin. Если один только origin так же медленный, исправлять нужно на origin; если напрямую он быстрый, а медленный только через CDN, ищите отличие в файрволе или маршрутизации, влияющее на соединение edge.

Какой тайм-аут origin по умолчанию на cdn.com.tr?

60 секунд без данных от вашего origin. Его можно задать для каждого правила доставки от 1 до 3 600 секунд в поле Тайм-аут ответа источника (секунды). На домене приложения Managed Container по умолчанию действует 300 секунд.

Стоит ли везде ставить тайм-аут 3 600 секунд?

Нет. Длинный тайм-аут на каждом пути означает, что при настоящей поломке посетители час смотрят на индикатор загрузки вместо ответа через минуту, а зависшие запросы копятся на вашем origin. Оставьте значение по умолчанию для сайта и увеличивайте его только в правиле для пути, медленного по замыслу.

Почему экспорт работает для маленьких файлов и падает для больших?

Потому что он строит весь файл, прежде чем отправить первый байт. Маленькие экспорты укладываются в лимит, большие — нет. Отдавайте файл потоком по мере генерации или запускайте экспорт фоновой задачей и присылайте ссылку для скачивания, когда он готов.

Может ли быть 504, если приложение быстрое?

Да, когда запросы ждут в очереди до начала обработки. Если заняты все воркеры, даже быстрый запрос может ждать достаточно долго, чтобы упереться в тайм-аут. 504, которые появляются только в загруженные часы, указывают на нехватку мощности, а не на код.

Поможет ли обновление страницы?

Иногда, но каждое обновление снова запускает ту же медленную работу на вашем origin. На тяжёлых страницах повторные обновления добавляют нагрузку именно тогда, когда серверу и так тяжело.