Ошибка 412 Precondition Failed: что значит и как исправить
412 Precondition Failed («условие не выполнено») — сервер не выполнил запрос, потому что не выполнилось условие, которое клиент поставил в заголовках. Так программы защищают данные: правка сохраняется, только если с момента загрузки данные никто не изменил.
Содержание 12
Что сделать прямо сейчас
- Если вы правили документ или запись, скопируйте свои изменения, обновите страницу — F5, на Mac Cmd+R — и внесите их заново. Пока вы работали, данные изменили: в другой вкладке, с другого устройства или другой человек.
- Если 412 получает ваша программа, пусть она загрузит свежую версию данных и повторит запрос с новой меткой версии. Подробнее — в разделе «Как исправить».
- Если ошибка повторяется на чужом сайте, напишите владельцу сайта: адрес страницы, время и что вы делали.
Если сайт ваш и работает на VPS с nginx, переходите к разделу «Как найти причину по журналу». Если сайт на виртуальном хостинге — к разделу «На виртуальном хостинге».
Что означает код 412
Клиент может поставить серверу условие: выполни запрос, только если данные на сервере в нужном состоянии. Условия задают заголовками:
| Заголовок | Условие | Если не выполнено |
|---|---|---|
| If-Match | Версия на сервере совпадает с указанной | 412 |
| If-Unmodified-Since | Данные не менялись после указанного времени | 412 |
| If-None-Match | Версия на сервере не совпадает с указанной | 304 для GET и HEAD, 412 для остальных методов |
Версию данных сервер сообщает в заголовке ETag. Это метка в кавычках, например "5f1a-1c8". Когда данные меняются, меняется и метка. Клиент запоминает её и отправляет в If-Match вместе с правкой.
По стандарту HTTP код 412 значит: одно или несколько условий в заголовках запроса оказались ложными, и сервер запрос не выполнил.
Как 412 защищает от затирания правок
- Анна и Иван открывают одну запись. Сервер отдаёт обоим её версию с меткой
"v1". - Анна сохраняет правку с заголовком
If-Match: "v1". Метки совпадают: сервер сохраняет правку, и у записи появляется новая метка —"v2". - Иван сохраняет свою правку тоже с
If-Match: "v1". На сервере уже"v2", условие не выполнено, и сервер отвечает 412, а не затирает правку Анны. - Программа Ивана загружает свежую версию с меткой
"v2", и Иван вносит правку заново.
Когда 412 отдаёт nginx
nginx сам проверяет условия, когда отдаёт файлы с диска — страницы, стили, картинки — с кодом 200 OK. Ответы программы сайта, которые nginx передаёт без кэширования, он не проверяет: условия должна обработать сама программа. Для файлов nginx отвечает 412, если:
- метка в If-Match не совпала с ETag файла. Метки сравниваются точно, вместе с кавычками;
- у ответа нет ETag. nginx отдаёт ETag для файлов по умолчанию, но его можно выключить строкой
etag off;. Тогда любое условие If-Match не выполняется — кромеIf-Match: *, которое значит «файл существует»; - файл изменён позже времени из If-Unmodified-Since или время изменения неизвестно.
Ещё 412 отдаёт модуль WebDAV: на запросы COPY и MOVE с заголовком Overwrite: F, если по адресу назначения уже что-то есть.
Как проверить
Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал. Вместо style.css подставьте любой файл со своего сайта — стиль или картинку. Сначала посмотрите, какую метку отдаёт сервер:
curl -I https://example.com/style.cssВ ответе найдите строку etag, например etag: "5f1a-1c8". Затем отправьте запрос с заведомо неверной меткой:
curl -I -H 'If-Match: "nope"' https://example.com/style.cssСервер, который проверяет условие, ответит 412. Если вместо "nope" подставить метку из первого ответа вместе с кавычками, ответ будет 200.
Как найти причину по журналу
Команды из этого раздела выполняйте на сервере — как к нему подключиться, рассказано в инструкции Как подключиться к VPS по SSH. Если вы ни разу не открывали терминал, начните с инструкции Как открыть терминал: там всё по шагам.
Все запросы nginx записывает в журнал доступа — в Ubuntu и Debian это файл /var/log/nginx/access.log. Какими методами и на какие адреса приходили запросы с ответом 412, покажет команда:
sudo awk '/" 412 / {print $6, $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -20В каждой строке ответа — сколько было таких запросов, затем метод с кавычкой перед ним и адрес. Например:
15 "PUT /api/notes/42
2 "GET /style.cssКоманда рассчитана на стандартный формат журнала nginx. Если в файле настроек сайта есть своя строка access_log, подставьте в команду путь из неё. Если команда ничего не вывела, записей с 412 в журнале нет.
Как исправить
- Перед правкой загружайте свежую версию данных и берите метку из заголовка ETag этого ответа. После 412 загрузите данные снова и повторите правку.
- Отправляйте метку в If-Match так, как она пришла в ETag, вместе с кавычками.
- Если в программе на странице правку теряет человек, покажите ему понятное сообщение: данные изменили, обновите страницу.
Если 412 получают запросы к файлам на вашем сервере с nginx, проверьте, не выключен ли ETag. Строки с директивой etag в настройках покажет команда:
sudo grep -rn etag /etc/nginx/Команда покажет файл, номер строки и саму строку. Если нашлась строка etag off;, а условные запросы к файлам нужны, откройте файл командой sudo nano и путём к нему, удалите строку и примените настройки.
Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -tВ ответе должны быть слова syntax is ok и test is successful. Если вместо них сообщение об ошибке, в нём указаны файл и номер строки: исправьте строку и проверьте снова. Когда проверка прошла, примените настройки:
sudo systemctl reload nginxЕсли команда ничего не ответила, настройки применены.
На виртуальном хостинге
На виртуальном хостинге 412 присылает программа сайта или сервер хостинга. Если ошибку получает ваш скрипт, проверьте заголовки с условиями, как описано выше. Если причину найти не удалось, напишите в поддержку хостинга: адрес страницы, время и что вы делали.
412 и поиск Яндекса
По справке Яндекса, при ответе 412 при проверке одного или нескольких полей заголовка запроса обнаружено несоответствие. Яндекс советует проверить логику условных запросов и убедиться, что кэширование работает правильно.
Чем 412 отличается от соседних кодов
Источники
- RFC 9110, раздел 15.5.13 — определение кода 412.
- RFC 9110, раздел 13.1.1 — If-Match; раздел 13.1.2 — If-None-Match: 304 для GET и HEAD, 412 для остальных методов; раздел 13.1.4 — If-Unmodified-Since.
- RFC 9110, раздел 8.8.3 — заголовок ETag.
- RFC 4918, раздел 10.6 — с
Overwrite: Fзапросы COPY и MOVE на занятое место завершаются 412. - Документация nginx: директива etag — по умолчанию включена, ETag отдаётся для статических файлов.
- Исходный код nginx 1.24.0: ngx_http_not_modified_filter_module.c — проверка If-Match и If-Unmodified-Since для ответов 200; без ETag условие If-Match не выполняется.
- Исходный код nginx 1.24.0: ngx_http_upstream.c — для ответов программы без кэширования проверка условий выключена.
- Исходный код nginx 1.24.0: ngx_http_dav_module.c — 412 для COPY и MOVE с
Overwrite: F. - Яндекс Вебмастер: коды ответа HTTP — код 412.
Сверено 19 октября 2026 года.
Что почитать дальше
- Ошибка 409 Conflictкогда запрос противоречит данным на сервере.
- Код 304 Not Modifiedкак браузер проверяет, изменилась ли страница.
- Команда curlкак отправлять запросы из терминала.
- Коды ответа HTTPполный список с расшифровкой.