414 Request-URI Too Long ("URI слишком длинный")

https://httpcat.ru/414

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

Описание

Код состояния 414 URI Too Long означает, что URI (адрес запроса) превышает максимально допустимую длину, установленную сервером, и не может быть обработан.

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

Сервер отклоняет запрос из-за **чрезмерно длинного URL**
Может быть вызван передачей слишком большого количества данных в строке запроса (например, через GET)
Это ограничение задаётся сервером или инфраструктурой (прокси, CDN и т.д.)

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

GET /search?query=очень-длинный-поисковый-запрос-и-ещё-много-много-параметров...
HTTP/1.1
Host: example.com

HTTP/1.1 414 URI Too Long
Content-Type: application/json

{
    "error": "The requested URL is too long to be processed"
}

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

Content-Type — может использоваться для описания причины отказа
Allow — не применяется, так как ошибка связана с URL, а не методом

Когда использовать:

Если URL превышает лимит (обычно 2–8 КБ в зависимости от сервера)
При неправильном использовании GET вместо POST (например, отправка формы через URL)
Когда клиент генерирует некорректно закодированные или бесконечно длинные ссылки

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

Рекомендуется использовать POST для передачи больших объёмов данных
На практике 414 чаще всего возникает в результате ошибок в генерации URL или чрезмерной вложенности параметров
Для API — полезно устанавливать ограничения на длину URI и обрабатывать их на клиентской стороне заранее

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/414