Ошибка 411 Length Required: что значит и как исправить
411 Length Required («нужна длина») — сервер отказался принять запрос, потому что в нём не указана длина тела в заголовке Content-Length. Так бывает, когда программа отправляет данные частями, не зная размер заранее, а сервер или посредник по пути хочет знать длину сразу.
Содержание 10
Что сделать прямо сейчас
- Если ошибка появилась в браузере при отправке формы, обновите страницу и отправьте ещё раз. Если не помогло, напишите владельцу сайта: адрес страницы, время и что отправляли.
- Если 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 отличается от соседних кодов
Источники
- RFC 9110, раздел 15.5.12 — определение кода 411; клиент может повторить запрос с Content-Length.
- RFC 9112, раздел 6.3 — сервер может ответить 411 на запрос с телом без Content-Length; если длина известна заранее, клиенту следует указывать её, а не отправлять тело частями.
- RFC 9110, раздел 8.6 — заголовок Content-Length.
- Документация curl — ключ
--json(с версии 7.82.0) и-H; заголовокTransfer-Encoding: chunkedвключает отправку тела частями. - Яндекс Вебмастер: коды ответа HTTP — код 411.
Сверено 19 октября 2026 года.
Что почитать дальше
- Ошибка 413 Request Entity Too Largeкогда тело запроса слишком большое.
- Ошибка 415 Unsupported Media Typeкогда сервер не принимает формат данных.
- Команда curlкак отправлять запросы из терминала.
- Коды ответа HTTPполный список с расшифровкой.