✦Первый в России сайт с полным циклом ИИ✦Смотрите презентацию ИИ-сайта продаж✦Сайт, которым полностью управляет ИИ✦Контент, реклама, лиды и аналитика — на автопилоте
Собрать игру

Ошибка 504 Gateway Timeout: причины и решение

12 мин чтения
С

Сергей и ЛеонидВедущий специалист по CRM AmSales

Внедряет Битрикс24 и amoCRM, автоматизирует продажи и бизнес-процессы. Золотой партнёр Битрикс24, 400+ проектов.

Ошибка 504 Gateway Timeout: причины и решение

Коротко: Ошибка 504 Gateway Timeout возникает, когда один сервер (прокси, шлюз или CDN) не получает своевременного ответа от другого сервера (backend, база данных или upstream), который должен был обработать запрос. Основные способы решения: поиск причины в логах, увеличение тайм-аутов в конфигурации Nginx/Apache и синхронизация лимитов PHP-FPM, а также оптимизация тяжелых запросов вместо бесконечного наращивания лимитов ожидания.

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

Когда пользователь заходит на сайт и видит 504 ошибку, это не значит, что сайт "упал" в привычном понимании. Сервер, который принимает запрос (например, Nginx или Cloudflare), работает исправно. Проблема заключается в цепочке передачи данных. Представьте, что вы пришли в ресторан, официант (шлюз) принял ваш заказ и ушел на кухню, но повара (backend) слишком долго готовят блюдо или вовсе замерли. Официант ждет, время на ожидание заканчивается, и он возвращается к вам с сообщением: "Извините, мы не успели получить ответ вовремя".

Технически HTTP 504 Gateway Timeout означает, что промежуточный узел, выполняющий роль прокси-сервера или балансировщика нагрузки, не дождался ответа от вышестоящего (upstream) сервера в установленный интервал времени. Это критическая ситуация для бизнеса, так как пользователь видит пустую страницу вместо контента, а поисковые роботы могут расценить это как нестабильность ресурса. Важно понимать разницу между 502 (Bad Gateway) и 504. При 502 соединение обрывается мгновенно из-за некорректного ответа, а 504 - это именно вопрос времени и задержек.

Для владельца бизнеса или маркетолога эта ошибка часто становится симптомом скрытых проблем. Она может проявляться эпизодически во время маркетинговых акций, когда нагрузка на базу данных резко возрастает, или постоянно, если в коде сайта есть неоптимизированные скрипты. В 2026 году, когда архитектуры сайтов стали еще сложнее из-за микросервисов, 504 ошибка может возникать на стыке десятков разных компонентов, и важно локализовать, где именно происходит затык.

Типовые сценарии появления ошибки включают в себя перегрузку процессора на сервере приложений, "зависшие" запросы к базе данных, которые блокируют другие процессы, или проблемы с сетевой связностью между узлами. Если вы видите 504, значит, ваш запрос ушел в "черную дыру" ожидания. Чтобы понять, как исправить 504 gateway timeout, нужно разобраться, на каком этапе цепочка прервалась.

Основные причины сбоя работы сервера

Причины ошибки 504 на сайте можно разделить на инфраструктурные и программные. Инфраструктурные проблемы связаны с "железом" или сетевыми настройками: нехватка оперативной памяти, перегрузка CPU или слишком узкие каналы связи между серверами. Если сервер приложений (например, тот, где крутится PHP или Python) не может обработать входящий поток из-за нехватки ресурсов, он начнет отвечать с огромной задержкой, что и приведет к срабатыванию тайм-аута на прокси-сервере.

Программные причины встречаются гораздо чаще. К ним относятся:

  • Медленные SQL-запросы, которые выполняются дольше, чем позволяет настройка прокси.
  • Внешние API-вызовы, которые "подвешивают" выполнение скрипта (например, запрос к платежному шлюзу или службе доставки).
  • Неправильная конфигурация очередей задач, когда тяжелые операции выполняются в основном потоке запроса, а не в фоне.
  • Утечки памяти в приложениях, из-за которых процессы начинают работать крайне медленно перед тем, как упасть.

Еще один важный фактор - это "эффект домино". Если один сервис в вашей системе начинает работать медленно, он занимает все доступные соединения (worker processes) на прокси-сервере. Новые запросы копятся, ресурсы исчерпываются, и вся система начинает выдавать 504 ошибку даже на те страницы, которые раньше работали быстро. Это классическая ситуация при резком наплыве трафика во время распродаж или рекламных кампаний.

Не стоит забывать и про базу данных. Часто именно она является "бутылочным горлышком". Если таблица не имеет нужных индексов или происходит блокировка строк (row locking) из-за длительной транзакции, любой запрос к этой таблице будет ждать. Прокси-сервер, не получив ответа от backend-а, который в свою очередь ждет БД, просто обрывает соединение по истечении лимита.

Как диагностировать проблему через логи

Диагностика без логов - это гадание на кофейной гуще. Первым делом нужно понять, кто именно генерирует ошибку. Если вы используете Nginx как фронтенд, откройте его error log. Ищите записи, содержащие фразу `upstream timed out`. Это прямой сигнал о том, что Nginx ждал ответа от вашего приложения (PHP-FPM, Node.js, Python) слишком долго и сдался.

Пример типичной записи в логе Nginx: `[error] 1234#0: *567 upstream timed out (110: Connection timed out) while reading response header from upstream, client: 1.2.3.4, server: example.com, request: "GET /api/heavy-report HTTP/1.1", host: "example.com"` Эта строка говорит нам о многом: ошибка произошла при чтении заголовка ответа, что подтверждает задержку именно на стороне backend-сервера.

Если в логах Nginx чисто, но пользователи жалуются на 504, проблема может быть глубже. Нужно проверить логи самого приложения и логи базы данных (например, MySQL slow query log). Если в slow query log вы видите запросы, которые выполняются по 10-30 секунд, значит, корень зла в неоптимизированной структуре БД. Также полезно проверить системные логи сервера (syslog или dmesg) на предмет ошибок Out Of Memory (OOM Killer), которые могут убивать процессы приложения в самый неподходящий момент.

Алгоритм быстрой диагностики:

  1. Проверить error log Nginx на наличие `upstream timed out`.
  2. Проверить логи приложения (Laravel, Django, WordPress и т.д.) на наличие ошибок выполнения или превышения лимитов времени.
  3. Изучить slow query log базы данных.
  4. Проверить загрузку CPU и RAM на сервере командой `top` или `htop`.
  5. Если используется CDN, проверить логи самого CDN-провайдера, чтобы понять, доходит ли запрос до вашего сервера вообще.

Настройка тайм-аутов в Nginx и Apache

Когда вы точно знаете, что конкретный запрос требует больше времени (например, генерация сложного PDF-отчета), вам придется корректировать настройки. Однако делать это нужно точечно. Если вы просто увеличите лимиты для всего сайта, вы рискуете тем, что при возникновении реальной проблемы (зависшем скрипте) сервер будет держать тысячи "мертвых" соединений, пока не закончится общий лимит, что окончательно добьет ресурсы.

В Nginx основным инструментом является настройка `proxy_read_timeout` и `fastcgi_read_timeout`. Если ваш сайт работает через PHP-FPM, то вам нужна именно настройка `fastcgi_read_timeout`. По умолчанию в Nginx этот параметр часто равен 60 секундам. Если ваш скрипт работает 65 секунд, клиент получит 504 ошибку. Чтобы исправить это только для определенного пути, используйте директиву `location` в конфигурационном файле:

location /api/export { fastcgi_read_timeout 300; proxy_read_timeout 300; include fastcgi_params; fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; } Такой подход безопасен: обычные пользователи на главной странице будут ограничены стандартным минутным лимитом, а тяжелые запросы получат 5 минут на выполнение.

С Apache ситуация несколько иная. Если вы используете `mod_proxy`, ключевым параметром является `ProxyTimeout`. В современных дистрибутивах (например, Ubuntu/Debian) он может наследоваться от глобального параметра `Timeout` и составлять около 300 секунд, но в базовых сборках часто стоит 60 секунд. Настройка производится в файле конфигурации виртуального хоста или в основном `apache2.conf`.

Важно помнить: увеличение тайм-аутов в веб-сервере - это "пластырь", а не лечение. Это позволяет запросу завершиться, но не решает проблему медленной работы кода. Если вы постоянно увеличиваете лимиты, это явный признак того, что архитектура приложения не справляется с нагрузкой или логикой обработки данных.

Синхронизация PHP-FPM и параметров прокси

Одна из самых частых ошибок при попытке исправить 504 gateway timeout - это настройка только веб-сервера (Nginx или Apache) без учета настроек интерпретатора (PHP-FPM). Это создает ситуацию рассинхронизации. Представьте: вы настроили Nginx так, чтобы он ждал ответа 300 секунд, но в настройках PHP параметр `max_execution_time` стоит на уровне 30 секунд. В итоге PHP принудительно завершит скрипт через полминуты, Nginx получит обрыв соединения и может выдать либо 502, либо 504, в зависимости от того, как именно закрылось соединение.

Для стабильной работы необходимо, чтобы цепочка тайм-аутов была согласованной. Логика должна быть такой: время ожидания на прокси-сервере (Nginx) должно быть чуть больше, чем максимально допустимое время выполнения скрипта в PHP. Это позволит PHP завершить работу и отдать ошибку (или результат), а прокси-сервер успеет это обработать.

Пример правильной связки для тяжелых задач:

  • Nginx: `fastcgi_read_timeout 120s;`
  • PHP (php.ini): `max_execution_time = 110`
  • PHP-FPM (pool config): `request_terminate_timeout = 115s`

Параметр `request_terminate_timeout` в конфиге пула PHP-FPM - это "жесткий" лимит, который убивает процесс, если он не завершился. Если он меньше, чем `max_execution_time` в `php.ini`, то процесс будет убит на уровне FPM. Если он больше, то сработает лимит самого PHP. Правильная настройка этой связки предотвращает появление "зомби-процессов", которые висят в системе и потребляют память, не выполняя полезной работы. Всегда проверяйте эти три точки: веб-сервер, настройки PHP и настройки пула FPM.

Проблемы с CDN и облачными сервисами

Если ваш сайт защищен Cloudflare или другим CDN, диагностика усложняется. CDN работает как первый эшелон перед вашим сервером. Если пользователь получает 504 ошибку с брендированной страницей Cloudflare, это означает, что CDN не дождался ответа от вашего "origin" (основного сервера). У Cloudflare есть свои жесткие лимиты: например, для платных тарифов время ожидания ответа от сервера обычно составляет около 125 секунд. Если ваш запрос длится дольше, Cloudflare просто оборвет соединение и покажет пользователю свою страницу ошибки.

В этом случае важно отличить: ошибка исходит от CDN или от вашего сервера. Если вы попробуете сделать запрос к своему серверу напрямую (минуя CDN, например, через IP-адрес или поддомен, который не проксируется), и получите 504 - проблема в вашем backend. Если же напрямую запрос проходит быстро, а через CDN - выдает 504, значит, проблема в настройках проксирования или в том, что ваш сервер не успевает обрабатывать запросы, идущие через узлы CDN.

Облачные балансировщики нагрузки (AWS ELB, Google Cloud Load Balancer) также имеют свои параметры `Idle Timeout`. В облачных средах часто бывает так: балансировщик настроен на 60 секунд, а ваш сервер на 300. В итоге, как только проходит 60 секунд без передачи данных, балансировщик разрывает соединение, и клиент видит 504, хотя ваш сервер все еще продолжает выполнять тяжелый расчет. Всегда синхронизируйте тайм-ауты на всех уровнях облачной инфраструктуры: балансировщик -> прокси -> приложение.

Также стоит учитывать, что CDN может кэшировать ошибки. Если ваш сервер выдал 504 один раз, некоторые настройки CDN могут начать отдавать эту ошибку всем последующим пользователям в течение нескольких минут, даже если сервер уже пришел в норму. В таких случаях помогает принудительная очистка кэша (Purge Cache) на стороне CDN-провайдера.

Оптимизация запросов вместо увеличения лимитов

Это самый важный раздел для любого разработчика и владельца бизнеса. Постоянное увеличение тайм-аутов - это путь к деградации системы. Чем дольше вы позволяете запросам "висеть", тем больше ресурсов они потребляют, тем быстрее забиваются пулы соединений и тем выше вероятность полного отказа системы. Вместо того чтобы спрашивать "как увеличить тайм-аут?", нужно спрашивать "почему этот запрос такой долгий?".

Существует несколько проверенных способов оптимизации:

fast
Метод Суть Когда применять
Фоновые очереди (Queues) Вынос тяжелых задач (рассылки, отчеты) в фоновый процесс (Redis, RabbitMQ). При любых операциях, занимающих более 1-2 секунд.
Кэширование Сохранение результата тяжелого запроса в Redis или Memcached. Для данных, которые меняются не каждую секунду.
Стриминг данных (Chunking) Отдача данных частями, а не одним огромным куском. При экспорте больших CSV или JSON файлов.
Оптимизация БД Добавление индексов, денормализация таблиц, оптимизация JOIN. Если slow query log показывает долгие запросы.

Наилучшая практика 2026 года - это асинхронная архитектура. Если пользователю нужно сгенерировать отчет, не заставляйте его ждать ответа HTTP-запроса. Вместо этого верните ответ "Запрос принят, мы сообщим вам, когда он будет готов", создайте задачу в очереди и отправьте уведомление (через WebSocket или email), когда отчет будет готов. Это полностью снимает проблему 504 ошибок, так как HTTP-соединение закрывается практически мгновенно, освобождая ресурсы сервера.

Также обратите внимание на объем передаваемых данных. Иногда 504 возникает не из-за долгого расчета, а из-за того, что сервер пытается передать через сеть гигантский объем данных (например, огромный JSON), и время передачи превышает лимит. В таких случаях лучше использовать пагинацию или разбиение данных на мелкие части.

/ уже делалиСпасли и переделали сайт производителя лабораторной мебели

Проверка сетевых соединений и Firewall

Иногда причина 504 ошибки лежит вообще вне кода и конфигурации веб-серверов - в сетевом уровне. Если ваш прокси-сервер и backend-сервер находятся на разных физических машинах или в разных сегментах сети, проблема может быть в сетевых задержках или потерях пакетов (packet loss). Если пакеты теряются, протокол TCP будет пытаться их переотправить, что создает огромные задержки, приводящие к таймауту.

Первое, что нужно сделать при подозрении на сетевые проблемы - выполнить трассировку (traceroute или mtr) между узлами. Это поможет увидеть, на каком переходе происходит задержка. Также стоит проверить настройки Firewall (iptables, ufw или облачные Security Groups). Если правила фаервола настроены так, что они слишком агрессивно фильтруют трафик или проверяют состояние соединений (stateful inspection), это может приводить к задержкам при установке TLS-соединения или при передаче больших объемов данных.

Проверьте также параметры MTU (Maximum Transmission Unit). Если на пути между серверами есть узлы с меньшим MTU, чем на ваших серверах, возникнет проблема фрагментации пакетов. Это часто случается при использовании VPN или специфических туннелей между дата-центрами. Фрагментация сильно замедляет работу и может приводить к тому, что запросы просто не успевают завершиться вовремя.

Еще один нюанс - DNS. Если ваш прокси-сервер обращается к upstream-серверу по доменному имени, а DNS-резолвер работает медленно или нестабильно, то время на разрешение имени может быть включено в общий тайм-аут ожидания. Рекомендуется использовать внутренние IP-адреса в конфигурациях Nginx/Apache, чтобы исключить зависимость от внешних DNS-сервисов при общении между внутренними компонентами системы.

В завершение стоит упомянуть про ретраи (retries). Если ваш клиент (браузер или другой сервис) настроен на автоматический повтор запроса при ошибке, и делает это слишком часто, не используя экспоненциальную задержку (backoff), он может создать "шторм запросов". Это только усугубит ситуацию: сервер, который и так едва справлялся, получает еще больше нагрузки, и 504 ошибки становятся массовыми. Настройка правильной политики повторов на стороне клиента - важная часть стабильности всей системы.

Что запомнить:

  • Ошибка 504 - это не падение сервера, а ожидание ответа от вышестоящего узла.
  • Всегда начинайте диагностику с логов Nginx (error log) и логов приложения.
  • Тайм-ауты в Nginx, PHP-FPM и PHP.ini должны быть синхронизированы.
  • Увеличение лимитов - временная мера; правильное решение - фоновые задачи и оптимизация БД.
  • Проверяйте сетевую связность и настройки Firewall, если проблема не в коде.
← Все статьи
Поделиться:

Сайт работает с ошибками или задержками?

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