Поиск
Ошибки

Ошибка 412 Precondition Failed: что значит и как исправить

412 Precondition Failed («условие не выполнено») — сервер не выполнил запрос, потому что не выполнилось условие, которое клиент поставил в заголовках. Так программы защищают данные: правка сохраняется, только если с момента загрузки данные никто не изменил.

≈ 7 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Если вы правили документ или запись, скопируйте свои изменения, обновите страницу — F5, на Mac Cmd+R — и внесите их заново. Пока вы работали, данные изменили: в другой вкладке, с другого устройства или другой человек.
  2. Если 412 получает ваша программа, пусть она загрузит свежую версию данных и повторит запрос с новой меткой версии. Подробнее — в разделе «Как исправить».
  3. Если ошибка повторяется на чужом сайте, напишите владельцу сайта: адрес страницы, время и что вы делали.

Если сайт ваш и работает на 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 защищает от затирания правок

  1. Анна и Иван открывают одну запись. Сервер отдаёт обоим её версию с меткой "v1".
  2. Анна сохраняет правку с заголовком If-Match: "v1". Метки совпадают: сервер сохраняет правку, и у записи появляется новая метка — "v2".
  3. Иван сохраняет свою правку тоже с If-Match: "v1". На сервере уже "v2", условие не выполнено, и сервер отвечает 412, а не затирает правку Анны.
  4. Программа Ивана загружает свежую версию с меткой "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 отличается от соседних кодов

КодКогда возникает
304Условие If-None-Match в запросе GET или HEAD: версия не изменилась, ответ без тела
409Запрос противоречит текущему состоянию данных
412Не выполнилось условие из заголовков запроса
416Запрошенный кусок файла выходит за его пределы

Источники

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

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