К содержимому

Ошибка nginx 499: что значит и как исправить

Код 499 в nginx означает, что клиент закрыл соединение раньше, чем сервер успел отдать ответ. Сначала смотрите в /var/log/nginx/access.log время выполнения запроса и в /var/log/nginx/error.log записи о таймаутах, затем проверяйте таймауты PHP-FPM и прокси.

Ошибка Nginx 3 мин чтения

01Клиент оборвал соединение до ответа сервера

Самая частая причина: браузер или скрипт закрыл соединение, не дождавшись ответа. В access.log у такого запроса стоит код 499, а время выполнения ($request_time) часто близко к таймауту клиента или больше него. Проверьте, не стоит ли на клиенте жёсткий таймаут, и не уходит ли запрос в никуда из-за долгого ответа бэкенда. Если запросы к PHP идут дольше 60 секунд, nginx может не успеть ответить, и клиент сдаётся первым. Увеличьте fastcgi_read_timeout в конфиге сайта, если бэкенд действительно работает долго.

bash
sudo tail -n 50 /var/log/nginx/access.log
sudo tail -n 50 /var/log/nginx/error.log

02Долгий ответ PHP-FPM или прокси

Если в error.log есть upstream timed out или запросы к PHP длятся десятки секунд, клиент может закрыть соединение раньше. По умолчанию fastcgi_read_timeout и proxy_read_timeout равны 60 секундам. Увеличьте их в блоке location для проблемного маршрута, но сначала выясните, почему бэкенд медленный: возможно, не хватает процессов PHP-FPM или запрос тяжёлый.

nginx
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_read_timeout 120s;
}

03Клиент закрыл соединение из-за большого тела запроса

При загрузке файлов через POST клиент может оборвать соединение, если nginx долго не отвечает или сразу возвращает 413. Проверьте client_max_body_size: по умолчанию 1 МБ, и запрос больше этого размера получит 413, а клиент может закрыть соединение. Увеличьте лимит в блоке server или location и перезагрузите nginx.

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/example.com/public;
    client_max_body_size 20m;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

04Ошибка в приложении или в пуле PHP-FPM

Если PHP-скрипт падает с фатальной ошибкой или превышает request_terminate_timeout, PHP-FPM может оборвать соединение, а nginx зафиксирует 499. Проверьте /var/log/php8.3-fpm.log и лог приложения. Убедитесь, что в пуле /etc/php/8.3/fpm/pool.d/www.conf значение request_terminate_timeout не меньше, чем таймауты в nginx.

bash
sudo tail -n 50 /var/log/php8.3-fpm.log
sudo systemctl status php8.3-fpm

05Как убедиться, что ошибка ушла

После правок проверьте конфиг и перезагрузите nginx. Затем отправьте тестовый запрос и посмотрите, появляется ли 499 в access.log. Если ошибка повторяется, сравните время выполнения запроса с таймаутами клиента и бэкенда.

bash
sudo nginx -t
sudo systemctl reload nginx
curl -I http://example.com/
sudo tail -n 20 /var/log/nginx/access.log

Что не помогает

  • Сразу увеличивать все таймауты nginx до максимума.

    Сначала найдите причину долгого ответа: медленный скрипт, нехватка процессов PHP-FPM или внешний сервис. Таймауты лишь скрывают симптом.

  • Менять права на файлы или владельца сайта при 499.

    Код 499 не связан с правами доступа. Проверяйте таймауты и логи PHP-FPM, а права трогайте только при 403.

  • Игнорировать логи PHP-FPM и приложения.

    В /var/log/php8.3-fpm.log и логе приложения видно, почему скрипт не успел ответить. Без этих данных правки в nginx могут не помочь.

Deploykin

Как это делается в Deploykin

В Deploykin логи nginx, PHP-FPM и приложения читаются в панели, без SSH. Конфиг nginx правится в редакторе: перед сохранением панель проверяет его на сервере, а прежняя версия уходит в резервную копию. Если nginx или PHP-FPM упадёт, придёт оповещение в Telegram.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Что означает код 499 в nginx?

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

Почему 499 появляется при быстрых запросах?

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

Нужно ли менять client_max_body_size при 499?

Только если запрос с телом превышает лимит и клиент обрывает соединение. По умолчанию лимит 1 МБ, при загрузке файлов его увеличивают в блоке server или location.

Какой таймаут в nginx отвечает за 499?

Прямого таймаута для 499 нет. На поведение влияют fastcgi_read_timeout и proxy_read_timeout (по умолчанию 60 секунд), а также таймауты на стороне клиента.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.