Исправляем 504 gateway time out Nginx

Ошибка 504 Gateway Timeout в Nginx означает, что сервер, на котором работает Nginx, не смог получить ответ от прокси-сервера в установленный период времени. Это обычно происходит из-за того, что прокси-сервер не может обработать запрос в течение заданного времени или из-за проблем с соединением между Nginx и прокси-сервером.

Почему появляется 504 Gateway Timeout

Ошибка возникает, когда сервер Nginx работает в режиме прокси. Так случается в случае применения php-fpm или Apache. Если перевести с английского на русский, получим следующее - превышено время ожидания ответа от сервера. 

Несколько причин такого поведения:

• скрипт PHP или на другом языке полностью завис и уже не вернет никакого ответа;
• скрипт работает очень долго, но в Nginx настроен интервал на сброс соединения если целевой сервер не ответил на запрос за отведенный строк;
• сервер перегружен и не успевает обслужить всех клиентов, вернуть ответы на все запросы Nginx.

Теперь поговорим, что же можно сделать и как устранить ошибку 504 Gateway Timeout.

Как исправить 504 gateway time out Nginx?

Первое, что следует попробовать на практике - если вашему серверу, php-fpm или apache не хватает ресурсов системы, например, памяти или процессора, посмотрите свободную ОЗУ с помощью команды free:

Нагрузку на процессор можно узнать командой htop:

Если вы видите, что PHP занимает все процессорное время, то значит проблема в ресурсах сервера. Можно попытаться разобраться с движком сайта, оптимизировать ресурс или выбрать мощный VPS сервер.

Второй вариант - если так и было запланировано, чтобы скрипт работал долго. В таком случае нужно настроить Nginx, чтобы он дождался ответа от Apache или php-fpm. Для решения проблемы в случае с php-fpm нужно только добавить две строчки в блок настройки fastgci:

300 означает 300 секунд, для большинства скриптов, этого хватает, но при необходимости также не составит труда установить больше. Также ошибка 504 может возникать, когда Nginx используется в качестве прокси для Apache или любого другого веб-сервера, тогда нужно еще настроить время ожидания для прокси. 

Добавьте эти строки в секцию server:

В данном случае имеем таймаут 600 секунд.

Теперь нам нужно перезапустить Nginx:

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

Более подробную информацию иногда можно увидеть в error.log:

Дальше, если проблема именно в php-fpm, вы можете отследить какие скрипты выполняются медленно с помощью встроенной функции slow-log.

Для ее активации добавьте следующие строки в конфигурацию вашего пула:

На этом инструкция завершена.