494 Request header too large ("слишком большой заголовок запроса")

https://httpcat.ru/494

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 494 Request Header Too Large — внутренний, неофициальный статус, используемый Nginx, когда клиент отправляет HTTP-запрос с заголовками, превышающими допустимый объём.

Основные характеристики:

Не входит в спецификацию HTTP, но используется в Nginx как часть внутренней логики
Возникает, когда суммарный размер заголовков или отдельного заголовка превышает значения, установленные в параметрах:
- large_client_header_buffers
- client_header_buffer_size
Запрос прерывается на этапе чтения заголовков — тело даже не обрабатывается

Типичное использование:

GET / HTTP/1.1
Host: example.com
Cookie: VERY_LARGE_COOKIE_STRING...

HTTP/1.1 494 Request Header Too Large
Content-Type: text/html

<html>
  <body>
    <h1>400 Bad Request</h1>
    <p>Request header too large</p>
  </body>
</html>

Когда возникает:

При использовании больших cookies (например, в системах авторизации, трекинга)
Если клиент отправляет длинные заголовки User-Agent, Referer или Authorization
Когда общий объём заголовков превышает конфигурационные лимиты

Особенности заголовков:

Заголовки запроса не проходят проверку на размер и отбрасываются сервером
Сервер может вернуть код 494 в логах, но для клиента часто виден 400

Дополнительно:

494 используется только в Nginx; в других серверах может возвращаться 431 Request Header Fields Too Large (официальный код)
Для устранения ошибки можно увеличить параметры large_client_header_buffers в конфигурации
Не должен использоваться в пользовательских API — это инфраструктурная ошибка

Документация: https://http.dev/494