Код 304 Not Modified: что значит и как работает кэш

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

Код 304 сервер отправляет в ответ на условный запрос GET или HEAD, если условие не выполнилось, то есть копия у клиента не устарела. Тела у такого ответа нет: клиент берёт данные из своего кэша, как если бы получил их с кодом 200. Заголовки ETag, Cache-Control, Expires, Date, Vary и Content-Location сервер обязан прислать с 304, если прислал бы их с ответом 200.

Как это работает

1. При первом запросе сервер отдаёт файл с кодом 200 и сообщает его версию: метку в заголовке ETag и время последнего изменения в заголовке Last-Modified. ETag — это метка версии; как её вычислять, решает сервер.
2. Браузер сохраняет файл в кэше. Когда файл снова нужен, браузер отправляет условный запрос: сохранённую метку — в заголовке If-None-Match, сохранённое время — в If-Modified-Since.
3. Если файл не изменился, сервер отвечает 304 без тела, и браузер берёт копию из кэша. Если изменился — сервер отдаёт новую версию с кодом 200.

Если в запросе есть оба заголовка, сервер проверяет If-None-Match, а If-Modified-Since не учитывает.

Как nginx отвечает 304

Для файлов, которые nginx отдаёт сам, он присылает Last-Modified и ETag и отвечает 304 на условные запросы — настраивать ничего не нужно. Метку ETag nginx собирает из времени последнего изменения файла и его размера: это два шестнадцатеричных числа через дефис, например "65f1a2b3-1c2d".

• Директива etag включает и выключает метку ETag для файлов; она есть с версии 1.3.3 и по умолчанию включена.
• Директива if_modified_since задаёт, как сравнивать время из If-Modified-Since: по умолчанию оно должно точно совпадать со временем изменения файла.

Ответы PHP и приложений за proxy_pass nginx сам на 304 не меняет, если не хранит их в своём кэше: на условные запросы должна отвечать программа сайта.

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

Узнать метку ETag файла:

curl -I https://example.com/style.css

Отправить условный запрос — в ответ должен прийти 304. Подставьте вместо 65f1a2b3-1c2d метку из ответа на первую команду:

curl -I -H 'If-None-Match: "65f1a2b3-1c2d"' https://example.com/style.css

В браузере то же видно в инструментах разработчика на вкладке Network («Сеть»): у файлов, которые браузер проверил и взял из кэша, в колонке статуса стоит 304.

Почему браузер показывает старую версию файла

Если сервер прислал с файлом заголовки Cache-Control или Expires со сроком хранения, браузер до конца срока вовсе не спрашивает сервер и не получает даже 304 — сразу показывает копию из кэша. Чтобы посетители сразу получили новую версию, меняйте адрес файла при каждом обновлении — например, добавляйте номер версии: style.css?v=2.

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

По справке Яндекса, ответ 304 стоит отдавать, если документ не изменился с последнего визита робота. Это особенно полезно для статических ресурсов, которые редко меняются, часто запрашиваются и много весят: индексирование идёт быстрее, а трафика расходуется меньше.

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

Источники

• RFC 9110, раздел 15.4.5 — определение кода 304; раздел 13.1.3 — If-Modified-Since и его связь с If-None-Match.
• Документация nginx: etag и if_modified_since.
• Исходный код nginx: ngx_http_core_module.c — как собирается ETag; ngx_http_upstream.c — ответы приложений.
• Яндекс Вебмастер: коды ответа HTTP.

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

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

• Код 200 OK — что значит обычный успешный ответ.
• Коды ответа HTTP — полный список с расшифровкой.
• Редирект 301 — постоянное перенаправление.
• Как разместить сайт на VPS — настройка nginx с нуля.