HTTP 499 в nginx: клиент оборвал запрос до ответа

В официальном перечне кодов ответа числа 499 нет. Его придумали разработчики nginx для журналов: запись со статусом 499 означает, что клиент закрыл соединение раньше, чем сервер успел отправить ответ. Поэтому обычный посетитель эту ошибку не видит: ему просто не пришёл ответ, потому что он сам ушёл со страницы, нажал остановку, закрыл вкладку или сработал его собственный тайм-аут.

Встретить 499 можно в журнале доступа, в отчётах мониторинга и иногда в сообщениях приложений, работающих через nginx как прокси.

Самая частая причина — медленный ответ. Пользователь ждёт, не дожидается и уходит, обновляет страницу или закрывает её. Если таких записей много, значит, часть запросов выполняется долго, и стоит смотреть на производительность приложения, базы данных или внешних служб.

Вторая причина — собственные тайм-ауты клиентов и промежуточных узлов: браузерные приложения, мобильные программы и балансировщики перед nginx имеют свои лимиты и обрывают соединение, не дождавшись. Третья — автоматические проверки и боты, которые опрашивают сервер и уходят по своим правилам. Четвёртая — нестабильная мобильная связь у пользователей.

Посмотрите время обработки запроса рядом с записью: если запросы с кодом 499 длятся много секунд, причина в медленных ответах. Если же они короткие, клиент уходит почти сразу, вероятно, это повторные нажатия, закрытие страниц или автоматические проверки.

Сгруппируйте записи по адресам: если 499 сосредоточены на одном методе, ищите проблему в нём. Сопоставьте с нагрузкой по времени суток и с релизами: рост числа обрывов после обновления часто указывает на регрессию производительности.

Оптимизируйте медленные обработчики: индексы в базе, кеширование, вынос тяжёлых задач в фоновую очередь. Согласуйте тайм-ауты по цепочке: клиент, балансировщик, nginx, приложение. Если клиент ждёт 30 секунд, а обработка занимает 60, обрывы неизбежны.

Проверьте настройку, определяющую, прерывать ли обработку при обрыве со стороны клиента: для операций с побочным эффектом, например платежа или записи, лучше довести работу до конца, чтобы не оставить систему в промежуточном состоянии.

Наконец, заведите отдельный график доли ответов 499 по времени: он быстро покажет, когда именно ухудшилась скорость ответов, и позволит связать рост обрывов с конкретным обновлением или пиком нагрузки.

Небольшая доля обрывов нормальна для любого сайта: люди закрывают вкладки, нажимают «назад», теряют связь в метро. Обычно это единицы процентов от общего числа запросов, и специально с ними бороться не нужно.

Тревожными считаются два признака. Первый — резкий рост числа 499 после релиза или под нагрузкой: он говорит о том, что ответы стали медленными и клиенты не выдерживают ожидания. Второй — концентрация на важных операциях, например на оформлении заказа или входе в систему: каждый оборванный запрос там означает потерянное действие пользователя.

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

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

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