HTTP 499 Client Closed Request: что означает, причины и как исправить

Что это значит

nginx записывает 499, когда клиент закрыл соединение до того, как сервер отправил ответ. Клиент этот код никогда не видит.

Типичные причины

Пользователь ушёл со страницы или отменил запрос
Тайм-аут клиента короче времени обработки на сервере
Тайм-аут проверки состояния у балансировщика

Как исправить

Если вы клиент или посетитель

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

Если вы владелец сайта или API

Ускорьте медленные эндпоинты и проверьте задержки вышестоящих сервисов; для работы, которая должна завершиться, рассмотрите proxy_ignore_client_abort.

Пример ответа

HTTP/1.1

HTTP/1.1 499 Client Closed Request
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0

Спецификация

Нет в реестре IANA; используется nginx.

Частые вопросы

› 499 — официальный код состояния?

Нет. Это код журнала nginx, он не передаётся по сети.

› Почему в журналах nginx много 499?

Клиенты или вышестоящие балансировщики сдаются первыми; сравните их тайм-ауты с временем ответа.