Код 204 No Content: что значит и когда сервер отвечает без тела
204 No Content («нет содержимого») — запрос выполнен успешно, но сервер ничего не присылает, кроме заголовков. Так отвечают на сохранение, удаление и служебные запросы, после которых показывать нечего. Это не ошибка, а успешный ответ.
Содержание 13
- Что означает код 204
- Как выглядит ответ 204
- Когда сервер отвечает 204
- 204 в API: ответ на PUT, PATCH и DELETE
- Чем 204 отличается от 200 с пустым телом
- Как вернуть 204 в nginx
- Как вернуть 204 в PHP
- Как проверить
- Почему 204 не подходит для страниц сайта
- Чем 204 отличается от соседних кодов
- Ответы на вопросы
- Источники
- Что почитать дальше
Что означает код 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 | Создан новый ресурс |
| 202 | Accepted: запрос принят, но обработка ещё не закончена |
| 204 | Запрос выполнен, тела нет |
| 205 | Reset 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 отдают как раз на них.
Источники
- RFC 9110, раздел 15.3.5 — определение кода 204: тела нет, браузеру не нужно уходить с текущей страницы; раздел 15.3.6 — код 205.
- RFC 9110, раздел 9.3.4 и раздел 9.3.5 — коды ответа на PUT и DELETE; ответы на эти методы не кэшируются. Раздел 15.3.3 — код 202.
- RFC 9110, раздел 15.3.1 — тело в ответе 200 и когда вместо него следует отвечать 204; раздел 8.6 — заголовок Content-Length в ответе 204 не отправляют.
- RFC 5789 — метод PATCH и пример ответа 204.
- Документация nginx: return — возвращает клиенту указанный код.
- Документация nginx: location — знак
=задаёт точное совпадение адреса. - Исходный код nginx 1.24.0: ngx_http_dav_module.c — ответ 204 при перезаписи файла, удалении, копировании и перемещении поверх существующего.
- Исходный код nginx 1.24.0: ngx_http_header_filter_module.c — для ответа 204 nginx убирает заголовки Content-Type и Content-Length.
- Документация PHP: функция http_response_code и исходный код PHP 8.3.6: head.c — код ответа из скрипта и предупреждение, если заголовки уже отправлены.
- Стандарт Fetch: null body status — список кодов, у ответов с которыми нет тела.
- Справка Google: как коды ответа HTTP влияют на роботов Google — при ответе 204 содержимое не обрабатывается.
Сверено 19 октября 2026 года; разделы про API, PHP, Google и заголовки ответа — 15 ноября 2026 года.
Что почитать дальше
- Код 200 OKуспешный ответ с телом.
- Код 201 Createdответ на создание нового ресурса.
- Код 304 Not Modifiedещё один ответ без тела.
- location в nginxкак nginx выбирает блок для адреса.
- Коды ответа HTTPполный список с расшифровкой.