Поиск
Ошибки

Ошибка 422 Unprocessable Content: что значит и как исправить

422 Unprocessable Content («необрабатываемое содержимое») — сервер понял формат данных в запросе, но обработать их не может. Например, в форме не заполнено обязательное поле или в адресе почты нет знака @. Раньше код назывался Unprocessable Entity.

≈ 5 мин чтения
Содержание 11

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

  1. Если ошибка появилась после отправки формы, проверьте поля: заполнены ли обязательные, верно ли записаны почта, телефон и даты. Исправьте и отправьте снова.
  2. Если 422 получает ваша программа, прочитайте тело ответа: сервер может перечислить в нём поля с ошибками. Как это сделать — в разделе «Как проверить».
  3. Если данные верные, а ошибка повторяется, напишите владельцу сайта: адрес страницы, время и что отправляли — без паролей и данных карт.

Если сайт ваш и работает на VPS с nginx, переходите к разделу «Как найти причину по журналу». Если сайт на виртуальном хостинге — к разделу «На виртуальном хостинге».

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

По стандарту HTTP код 422 значит: сервер понимает формат данных в запросе — поэтому это не 415 — и данные записаны по правилам, но выполнить то, что в них сказано, сервер не может. Стандарт приводит пример: XML-документ составлен правильно, но по смыслу в нём ошибка.

Программа сайта может ответить 422, если данные не прошли проверку: пустое обязательное поле, слишком длинный текст, почта без знака @, дата в прошлом там, где нужна будущая. Например, фреймворк Laravel отвечает 422, когда не прошли проверку данные из запроса, который ждёт ответ в JSON, и присылает в ответе сообщения об ошибках.

Кто отвечает 422

Код 422 отдаёт программа сайта или API: проверку данных делает она. Если сайт работает на nginx, проверьте, нет ли в настройках строки return 422;, — поможет команда на сервере. Как к нему подключиться, рассказано в инструкции Как подключиться к VPS по SSH.

sudo grep -rn 'return 422' /etc/nginx/

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

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

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

curl -i --json '{"email":"test"}' https://example.com/api/subscribe/

Ключ -i показывает заголовки ответа, а под ними — тело. Если сервер ответил 422, ищите в теле, какие поля не прошли проверку и почему. Команды отправляют настоящий запрос: если адрес создаёт записи, появится тестовая запись — потом удалите её.

В браузере

Откройте инструменты разработчика клавишей F12, на Mac — Cmd+Option+I, перейдите на вкладку Network («Сеть») и отправьте форму ещё раз. Нажмите на запрос с кодом 422: ответ сервера с описанием ошибок можно посмотреть на одной из вкладок этого запроса.

Как найти причину по журналу

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

Все запросы nginx записывает в журнал доступа — в Ubuntu и Debian это файл /var/log/nginx/access.log. Какими методами и на какие адреса приходили запросы с ответом 422, покажет команда:

sudo awk '/" 422 / {print $6, $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -20

В каждой строке ответа — сколько было таких запросов, затем метод с кавычкой перед ним и адрес. Например:

     18 "POST /api/subscribe/
      4 "PUT /api/profile

Команда рассчитана на стандартный формат журнала nginx. Если в файле настроек сайта есть своя строка access_log, подставьте в команду путь из неё. Если команда ничего не вывела, записей с 422 в журнале нет.

Как исправить

Если 422 получает ваша программа

  • Сверьте данные с документацией API: обязательные поля, типы значений, формат дат и длину строк.
  • Показывайте человеку сообщение об ошибке из ответа сервера, а не только код.

Если 422 отдаёт ваш сайт

  • Сообщайте в ответе, какое поле и почему не прошло проверку: без этого клиент не узнает, что исправить.
  • Проверяйте данные и на странице, до отправки, — тогда человек увидит ошибку сразу. Проверку в программе на сервере при этом оставьте: данные можно отправить и в обход формы.
  • Если 422 приходит на данные, которые выглядят верными, проверьте правила проверки в программе: например, ограничение длины или формат телефона.

На виртуальном хостинге

На виртуальном хостинге 422 присылает программа сайта — например, движок сайта или плагин формы. Сверьте данные с правилами формы. Если причину найти не удалось, напишите разработчику программы или в поддержку хостинга: адрес страницы, время и что отправляли.

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

По справке Яндекса, при ответе 422 сервер не может обработать один или несколько элементов запроса. Яндекс советует улучшить проверку входящих данных и убедиться, что клиенты получают понятные сообщения о причинах ошибки.

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

КодКогда возникает
400Запрос испорчен, сервер не может его разобрать
409Запрос противоречит текущему состоянию данных
415Сервер не принимает формат данных
422Формат понятен, но данные не прошли проверку

Источники

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

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