Ошибка 504 Gateway Time-out¶
504 Gateway Time-out — код состояния HTTP, сообщающий, что прокси-сервер или шлюз (gateway) не получил вовремя ответа от вышестоящего сервера, к которому обратился от имени клиента. Код входит в категорию ошибок класса 5xx («серверная ошибка») и означает, что запрос не выполнен из-за проблем на стороне сервера, а не пользователя. Стандарт определён в RFC 7231 (2014) и его преемнике RFC 9110 (2022).
¶Причины возникновения
Ошибка 504 возникает, когда посредник (прокси, балансировщик нагрузки, шлюз) отправил запрос на внутренний сервер, но тот не ответил за отведённое время. Наиболее частые причины:
- Перегрузка сервера — исчерпаны ресурсы CPU, памяти или соединений, обработка запроса поставлена в очередь.
- Медленная работа приложения — долгие запросы к базе данных, тяжёлые вычисления, неоптимизированные запросы.
- Недоступность бэкенда — целевой сервер упал, не запущен или недоступен по сети.
- Слишком короткий таймаут — прокси настроен жёстче, чем реальное время ответа приложения.
- Сетевые проблемы — обрыв связи между шлюзом и внутренним сервером, переполнение очередей.
- Отказ внешних зависимостей — приложение ожидает ответа от стороннего API, которое не отвечает.
¶Отличие от других ошибок
| Код | Название | Смысл |
|---|---|---|
| 408 | Request Timeout | Клиент не отправил запрос за отведённое время |
| 500 | Internal Server Error | Сервер столкнулся с непредвиденной ошибкой |
| 502 | Bad Gateway | Шлюз получил некорректный или неполный ответ от вышестоящего сервера |
| 504 | Gateway Time-out | Шлюз не получил ответа от вышестоящего сервера вообще |
| 503 | Service Unavailable | Сервер временно не принимает запросы (обычно при перегрузке или обслуживании) |
Ключевое отличие 504 от 502: при 502 ответ пришёл, но был ошибочным; при 504 ответ не пришёл за отведённый интервал.
¶Что означает для пользователя
Для посетителя сайта ошибка 504 выглядит как «страница не загрузилась» или «сервер не отвечает». Повторная попытка часто помогает, если проблема временная. Если ошибка повторяется, обычно рекомендуется:
- Проверить соединение с интернетом.
- Очистить кэш браузера.
- Попробовать открыть сайт позже или через другую сеть.
- Обратиться к администратору сайта, если ошибка сохраняется.
Для пользователя 504 — не ошибка в его браузере или сети: запрос дошёл до сервера, но тот не успел ответить.
¶Как исправить на стороне сервера
Для администраторов и разработчиков типичные решения:
- Увеличить таймаут в конфигурации прокси (nginx —
proxy_read_timeout, Apache —ProxyTimeout, балансировщики — соответствующие параметры). - Оптимизировать приложение — ускорить запросы к БД, кэшировать результаты, асинхронизировать долгие операции.
- Масштабировать инфраструктуру — добавить серверы, балансировать нагрузку, включить автоскейлинг.
- Мониторинг и алерты — отслеживать время ответа, чтобы замечать деградацию до появления 504 у пользователей.
- Проверить внешние зависимости — убедиться, что сторонние сервисы отвечают вовремя.
¶Примеры конфигураций
В nginx стандартный таймаут ожидания ответа от бэкенда — 60 секунд. Если приложение отвечает дольше, прокси вернёт клиенту 504. Увеличение значения:
`` location / { proxy_read_timeout 120s; proxy_connect_timeout 10s; } ``
В Apache HTTP Server аналогичный параметр задаётся через ProxyTimeout.
¶Интересные факты
- Код 504 исторически ассоциируется с прокси-сервером Squid, который широко использовался в российских корпоративных сетях в 2000-х годах; именно оттуда многие пользователи впервые увидели сообщение «504 Gateway Time-out».
- Код 504 не является ошибкой кэширования: ответ 504 обычно не кэшируется, и повторный запрос уходит на сервер заново.
- Некоторые CDN и облачные платформы (например, Cloudflare) показывают собственные страницы вместо стандартного ответа 504, добавляя пояснения для пользователя.
Источники:
- RFC 9110: HTTP Semantics (IETF, 2022)
- RFC 7231: Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content (IETF, 2014)
- Документация nginx: Module ngx_http_proxy_module
- Документация Apache HTTP Server: mod_proxy
- MDN Web Docs: HTTP response status codes
