Ошибка nginx 499: что значит и как исправить
Код 499 в nginx означает, что клиент закрыл соединение раньше, чем сервер успел отдать ответ. Сначала смотрите в /var/log/nginx/access.log время выполнения запроса и в /var/log/nginx/error.log записи о таймаутах, затем проверяйте таймауты PHP-FPM и прокси.
01Клиент оборвал соединение до ответа сервера
Самая частая причина: браузер или скрипт закрыл соединение, не дождавшись ответа. В access.log у такого запроса стоит код 499, а время выполнения ($request_time) часто близко к таймауту клиента или больше него. Проверьте, не стоит ли на клиенте жёсткий таймаут, и не уходит ли запрос в никуда из-за долгого ответа бэкенда. Если запросы к PHP идут дольше 60 секунд, nginx может не успеть ответить, и клиент сдаётся первым. Увеличьте fastcgi_read_timeout в конфиге сайта, если бэкенд действительно работает долго.
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 или запрос тяжёлый.
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.
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.
sudo tail -n 50 /var/log/php8.3-fpm.log
sudo systemctl status php8.3-fpm
05Как убедиться, что ошибка ушла
После правок проверьте конфиг и перезагрузите nginx. Затем отправьте тестовый запрос и посмотрите, появляется ли 499 в access.log. Если ошибка повторяется, сравните время выполнения запроса с таймаутами клиента и бэкенда.
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 Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Ошибка · Nginx Ошибка 403 Forbidden в nginx: причины и исправление Разбираем ошибку 403 Forbidden в nginx: как найти причину по error.log, проверить права через namei и sudo -u www-data, исправить chmod и deny. Команды для Ubuntu…
- Ошибка · Nginx nginx error log: как читать и исправлять ошибки Разбираем записи nginx error log: 403, 502, 504, 413 и другие. Показываем, как найти причину по логу, проверить права, сокет PHP-FPM и конфиг, и что сделать для…
- Ошибка · Nginx Ошибка 500 Internal Server Error в nginx: поиск причины и исправление Разбираем ошибку 500 в nginx: как найти причину в error.log, проверить PHP-FPM, права и конфиг, исправить и убедиться, что ошибка ушла.
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы