Поиск
Справочник

Код 204 No Content: что значит и когда сервер отвечает без тела

204 No Content («нет содержимого») — запрос выполнен успешно, но сервер ничего не присылает, кроме заголовков. Так отвечают на сохранение, удаление и служебные запросы, после которых показывать нечего. Это не ошибка, а успешный ответ.

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

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

Код 204 значит, что сервер выполнил запрос и больше ему нечего прислать. Ответ заканчивается на заголовках: тела у него быть не может.

По стандарту после 204 браузеру не нужно уходить с текущей страницы. Поэтому 204 подходит для действий, после которых человек остаётся на месте: кнопка «Сохранить» в редакторе документа, удаление записи из списка, служебный запрос из скрипта страницы.

Как выглядит ответ 204

Так отвечает nginx по протоколу HTTP/1.1:

HTTP/1.1 204 No Content
Server: nginx/1.24.0 (Ubuntu)
Date: Sun, 15 Nov 2026 10:00:00 GMT
Connection: keep-alive

После заголовков идёт пустая строка — и на этом ответ заканчивается. Строк Content-Type и Content-Length в нём нет: по стандарту сервер не должен присылать Content-Length в ответе 204, и nginx убирает оба заголовка сам.

По протоколу HTTP/2 первая строка в выводе curl короче — HTTP/2 204, а имена заголовков написаны строчными буквами.

Заголовки ответа 204 относятся к ресурсу в том виде, какой он принял после запроса. Например, если после сохранения документа сервер прислал заголовок ETag, это метка уже новой версии.

Когда сервер отвечает 204

  • API после удаления или изменения записи, если возвращать нечего.
  • Служебный адрес для проверки, работает ли сервер: ответ 204 значит «жив», а тело не нужно.
  • nginx с модулем WebDAV: PUT поверх существующего файла, DELETE, а также COPY и MOVE файла. Создание нового файла запросом PUT даёт 201 Created.

204 в API: ответ на PUT, PATCH и DELETE

Стандарт HTTP прямо называет коды, которыми сервер отвечает на изменение и удаление:

ЗапросЧто произошлоКод ответа
PUTСоздан новый ресурс201
PUTИзменён существующий ресурс200 или 204
DELETEУдаление выполнено, сообщить больше нечего204
DELETEУдаление выполнено, в ответе есть описание результата200
DELETEЗапрос принят, но удаление ещё не выполнено202

Для метода PATCH, которым меняют часть ресурса, подход тот же. В примере из стандарта сервер отвечает на PATCH кодом 204, потому что тела в ответе нет; другие успешные коды тоже допустимы.

Правило простое: если клиенту нужно что-то вернуть — изменённую запись, её номер, описание результата, — отвечайте 200 с телом. Если вернуть нечего — 204.

Чем 204 отличается от 200 с пустым телом

Ответ 200 с заголовком Content-Length: 0 — это страница нулевой длины. Если такой ответ придёт на переход по ссылке, браузер покажет пустую страницу. Ответ 204 значит другое: показывать нечего и уходить с текущей страницы не нужно.

Стандарт описывает это так: в ответе 200 ожидается тело — либо прямое указание, что его длина равна нулю. А если по запросу видно, что тело клиенту не нужно, серверу следует ответить 204.

Как вернуть 204 в nginx

Директива return отдаёт код сразу, без обращения к файлам и программе сайта. Пример — адрес /ping, который отвечает 204: по нему удобно проверять, работает ли сервер.

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

Настройки nginx меняют в файле настроек сайта. Он лежит в папке /etc/nginx/sites-available/ — это тот файл, который вы создавали по инструкции Как разместить сайт на VPS: nginx с нуля. Откройте его на сервере, подставив вместо example.com имя своего файла:

sudo nano /etc/nginx/sites-available/example.com

Если блоков server в файле несколько, нужен тот, где есть строка root — путь к папке сайта, — а если сайт работает по HTTPS, ещё и строка listen 443. Как перемещаться по файлу и вставлять текст, рассказано в разделе про nano. Добавьте внутрь блока server строки:

location = /ping {
    return 204;
}

Знак = значит точное совпадение: правило сработает только для адреса /ping.

Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:

sudo nginx -t

В ответе должны быть слова syntax is ok и test is successful. Если вместо них сообщение об ошибке, в нём указаны файл и номер строки: исправьте строку и проверьте снова. Когда проверка прошла, примените настройки:

sudo systemctl reload nginx

Если команда ничего не ответила, настройки применены.

Как вернуть 204 в PHP

В скрипте PHP код ответа задаёт функция http_response_code. Пример — файл, который отвечает 204 и больше ничего не присылает:

<?php
http_response_code(204);
exit;

Строка <?php должна быть в файле самой первой: без пробелов и пустых строк перед ней. Код ответа сервер отправляет раньше тела, поэтому функцию вызывают до любого вывода. Если скрипт уже начал отправлять ответ, сменить код PHP не сможет и выдаст предупреждение — причина та же, что у ошибки Cannot modify header information.

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

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

curl -i https://example.com/ping

В первой строке ответа должен быть код 204, после заголовков — ничего. В браузере код видно в инструментах разработчика на вкладке Network («Сеть»), в колонке статуса.

Почему 204 не подходит для страниц сайта

Страница, которую должны видеть посетители и находить поисковики, должна отвечать 200 и отдавать содержимое. В ответе 204 содержимого нет — показывать и индексировать нечего. По справке Google, при ответе 204 робот не получает содержимого и обработать страницу не может.

Если страница сайта вдруг отвечает 204, проверьте, нет ли для её адреса строки return 204 в настройках nginx. Эта команда на сервере покажет файл и номер строки:

sudo grep -rn "return 204" /etc/nginx/

Если команда ничего не вывела, код 204, по всей видимости, отдаёт программа сайта — CMS или приложение: причину ищите в ней.

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

КодКогда возникает
200Запрос выполнен, в ответе есть тело
201Создан новый ресурс
202Accepted: запрос принят, но обработка ещё не закончена
204Запрос выполнен, тела нет
205Reset Content: запрос выполнен, клиенту стоит очистить форму или вернуть её в исходное состояние
304Ресурс не изменился, клиент берёт копию из кэша

Ответы на вопросы

Что значит ответ сервера 204? Запрос выполнен успешно, но прислать в ответ нечего: у такого ответа есть только заголовки. No Content переводится как «нет содержимого».

Код 204 — это ошибка? Нет. Коды, которые начинаются на 2, значат успех: сервер выполнил запрос. Код 204 добавляет к этому одно: тела в ответе нет.

Чем 204 отличается от 200? Оба кода значат успех. Разница в теле ответа: при 200 оно есть или прямо указано, что его длина равна нулю, а при 204 тела нет и быть не может. Подробнее — в разделе «Чем 204 отличается от 200 с пустым телом».

Какой код отдавать на DELETE — 200, 202 или 204? Код 204 — если удаление выполнено и сообщить больше нечего. Код 200 — если в ответе есть описание результата. Код 202 — если запрос принят, но удаление ещё не выполнено.

Можно ли передать текст или JSON в ответе 204? Нет: тела у такого ответа нет. В стандарте Fetch, по которому браузеры выполняют запросы, код 204 входит в список ответов без тела. Поэтому в скрипте страницы сначала проверяйте код ответа и не разбирайте ответ 204 как JSON: пустая строка — не JSON. Если клиенту нужны данные, отвечайте 200.

Почему в ответе 204 нет заголовка Content-Length? По стандарту сервер не должен присылать Content-Length в ответе 204: тела нет, и длину указывать незачем. nginx убирает этот заголовок сам.

Я нажал ссылку, а страница не изменилась. Это из-за 204? Может быть: по стандарту после ответа 204 браузеру не нужно уходить с текущей страницы. Проверьте адрес ссылки командой curl -i из раздела «Как проверить»: код будет в первой строке ответа.

Страница сайта отвечает 204 вместо 200. Что делать? Найдите, что отдаёт этот код: строка return 204 в настройках nginx или программа сайта. Как искать, рассказано в разделе «Почему 204 не подходит для страниц сайта».

Сохраняется ли ответ 204 в кэше? Стандарт это разрешает, если заголовки ответа не запрещают. Но ответы на запросы PUT и DELETE по стандарту в кэш не попадают — а в API код 204 отдают как раз на них.

Источники

Сверено 19 октября 2026 года; разделы про API, PHP, Google и заголовки ответа — 15 ноября 2026 года.

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