Поиск
Ошибки

Ошибка 411 Length Required: что значит и как исправить

411 Length Required («нужна длина») — сервер отказался принять запрос, потому что в нём не указана длина тела в заголовке Content-Length. Так бывает, когда программа отправляет данные частями, не зная размер заранее, а сервер или посредник по пути хочет знать длину сразу.

≈ 5 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Если ошибка появилась в браузере при отправке формы, обновите страницу и отправьте ещё раз. Если не помогло, напишите владельцу сайта: адрес страницы, время и что отправляли.
  2. Если 411 получает ваша программа, проверьте, указывает ли она заголовок Content-Length. Как это сделать — в разделе «Как проверить».

Если сайт ваш и работает на VPS с nginx, переходите к разделу «Как найти причину по журналу». Если сайт на виртуальном хостинге — к разделу «На виртуальном хостинге».

Что означает код 411

Если у запроса есть тело — данные формы, файл, JSON, — клиент сообщает серверу, где оно заканчивается, одним из двух способов:

  • Заголовок Content-Length — длина тела в байтах. Так отправляют данные, размер которых известен заранее.
  • Заголовок Transfer-Encoding: chunked — данные идут частями, и у каждой части свой размер. Так отправляют данные, размер которых заранее неизвестен.

По стандарту HTTP код 411 значит: сервер отказывается принять запрос без заголовка Content-Length. Клиент может повторить запрос, указав длину.

Стандарт предупреждает, что некоторые сервисы отвечают 411 на тело частями, хотя такой способ понимают. Их запросы обрабатывает посредник, которому длина нужна заранее, а сервер не может или не хочет сначала принять всё тело целиком. Поэтому, если размер данных известен, клиенту следует указывать Content-Length, а не отправлять данные частями.

Как проверить

Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал. Вместо адреса из примера подставьте тот, куда ваша программа отправляет данные.

Сначала отправьте данные целиком: curl сам укажет их длину в заголовке Content-Length.

curl -i --json '{"name":"test"}' https://example.com/api/orders/

Затем те же данные частями: с заголовком Transfer-Encoding: chunked curl отправляет тело частями и длину не указывает.

curl -i --json '{"name":"test"}' -H 'Transfer-Encoding: chunked' https://example.com/api/orders/

Если первая команда проходит, а вторая получает 411, сервер требует длину заранее. Тогда исправлять нужно программу, которая отправляет запрос.

Команды отправляют настоящий запрос: если адрес создаёт записи, появится тестовая запись — потом удалите её. Ключ --json отправляет данные как JSON и есть в curl с версии 7.82.0. Если curl пишет, что не знает такого ключа, обновите его.

Как найти причину по журналу

Команды из этого раздела выполняйте на сервере — как к нему подключиться, рассказано в инструкции Как подключиться к VPS по SSH. Если вы ни разу не открывали терминал, начните с инструкции Как открыть терминал: там всё по шагам.

Все запросы nginx записывает в журнал доступа — в Ubuntu и Debian это файл /var/log/nginx/access.log. Какими методами и на какие адреса приходили запросы с ответом 411, покажет команда:

sudo awk '/" 411 / {print $6, $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -20

В каждой строке ответа — сколько было таких запросов, затем метод с кавычкой перед ним и адрес. Например:

      7 "POST /api/orders/
      2 "PUT /upload/photo.jpg

Команда рассчитана на стандартный формат журнала nginx. Если в файле настроек сайта есть своя строка access_log, подставьте в команду путь из неё. Если команда ничего не вывела, записей с 411 в журнале нет.

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

  • Если размер данных известен — файл с диска, готовая строка JSON, — передавайте их целиком, а не потоком: тогда длину можно указать в Content-Length. Как это сделать, сказано в документации библиотеки, через которую программа отправляет запросы.
  • Если данные появляются по ходу и размер заранее неизвестен, сначала соберите их целиком — в памяти или во временном файле — и только потом отправляйте.
  • Если запрос уходит в чужой API, посмотрите в его документации, требует ли он Content-Length.

На виртуальном хостинге

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

411 и поиск Яндекса

По справке Яндекса, при ответе 411 сервер отказывается принимать запрос без заголовка Content-Length. Яндекс советует поправить заголовки на сервере, чтобы робот смог проиндексировать страницу в следующий раз.

Чем 411 отличается от соседних кодов

КодКогда возникает
400Запрос испорчен, сервер не может его разобрать
411В запросе с телом не указана длина
413Тело запроса больше, чем разрешено на сервере
415Тело запроса в формате, который сервер не принимает

Источники

Сверено 19 октября 2026 года.

Что почитать дальше