При работе с веб-сайтами или API пользователи и разработчики часто видят сообщения HTTP 400 Bad Request («Некорректный запрос»). В отличие от ошибок серии 5xx, указывающих на сбой самого сервера, статус 400 относится к клиентским ошибкам (4xx): сервер отклонил запрос, так как не смог распознать или корректно обработать его из-за нарушений синтаксиса, поврежденных данных или превышений допустимых лимитов.
Эта проблема может возникать как на стороне пользователя (из-за устаревших cookie или ошибке в адресной строке), так и на стороне бэкенда или веб-сервера (например, из-за слишком больших заголовков запроса или некорректного формата JSON в REST API).
Основные причины ошибки HTTP 400
Чтобы быстро найти решение, важно понимать типичные источники ошибки 400:
- Поврежденные или слишком большие Cookies и кэш браузера: Накопленные файлы
cookieдля конкретного домена могут содержать устаревшие токены сессии или превышать допустимый размер заголовка, из-за чего сервер отклоняет запрос. - Синтаксическая ошибка в URL или параметрах запроса: Некорректная кодировка спецсимволов (пробелов, кириллицы, амперсандов в query-параметрах) или ручное редактирование адреса с нарушением структуры.
- Слишком большой размер файла или заголовков (Headers): Если размер загружаемого файла или HTTP-заголовков (например, при авторизации через
OAuth/JWTили сложных фильтрах) превышает лимиты Nginx/Apache, или приложения. - Невалидный формат тела запроса (Payload / JSON): В веб-приложениях и API ошибка 400 часто возникает, когда клиент посылает невалидный JSON, отсутствует обязательное поле или значение неверного типа данных.
- Проблемы с локальным DNS или сетевым подключением: Некорректный резолв адреса или конфликт в настройках сети/прокси.
Сравнительный анализ: HTTP 400 и другие ошибки серии 4xx
| Код | Название | Суть проблемы | Отличие от 400 |
|---|---|---|---|
| 400 | Bad Request | Запрос сформирован с ошибкой или содержит неприемлемые данные. | Базовый статус некорректного запроса – сервер не принимает его еще до проверки прав или наличия ресурса. |
| 401 | Unauthorized | Адтентификация пользователя отсутствует или она недействительна. | Запрос синтаксически корректен, но требует входа в аккаунт или валидного токена. |
| 403 | Forbidden | Сервер понял запрос, но запретил доступ к ресурсу. | Пользователь идентифицирован или запрос корректен, однако не хватает прав доступа или сработал WAF/правило доступа. |
| 404 | Not Found | Запрашиваемая URL не найдена на сервере. | Адрес сформирован правильно, но соответствующего ресурса или страницы по этому пути нет. |
Пошаговая инструкция по устранению ошибки 400
- Шаг 1: Проверьте URL-адрес и входящие параметры.
Убедитесь, что в адресной строке нет лишних символов, дублирования или ошибок после ручного редактирования ссылки. Если вы работаете с формой или API, проверьте переданные параметры и валидность JSON.
Проверка: Откройте чистую главную страницу домена или повторите запрос с корректными параметрами – если страница загрузилась, проблема была в самом запросе или параметрах. - Шаг 2: Очистите Cookies и кэш для проблемного сайта.
В браузере откройте инструменты разработчика (F12) → вкладка Application (Приложение) → Cookies и удалите файлыcookieдля текущего домена (или очистите кэш и cookie сайта в настройках).
Проверка: Обновите страницу (Ctrl + F5илиCmd + Shift + R) или откройте ссылку в режиме Инкогнито – исчезновение ошибки подтвердит, что причина была в устаревших cookie или сессии. - Шаг 3: Проверьте размер загружаемых файлов и заголовков.
Если ошибка 400 появляется при загрузке файла или отправке большой формы, проверьте ограничение веб-сервера и PHP/бэкенда. В конфигурации Nginx обратите внимание на параметрыclient_max_body_sizeиlarge_client_header_buffers:server { # Увеличиваем допустимый размер тела запроса (например, для загрузки файлов) client_max_body_size 32M; # Увеличиваем буфер для больших заголовков запроса (например, длинных cookie или токенов) large_client_header_buffers 4 16k; }Проверка: Проверьте синтаксис конфигурации командой
nginx -t, перезагрузите сервис (systemctl reload nginx) и повторите действие, вызвавшее ошибку. - Шаг 4: Проанализируйте логи сервера и ответ API.
Если вы являетесь разработчиком или администратором, проверьте логи доступа и ошибок веб-сервера (/var/log/nginx/access.log,/var/log/nginx/error.logили логи Apache) и вкладку Network в DevTools.
Проверка: В ответе API или в логах приложения обычно указывается конкретное поле или причина (например, невалидный тип параметра или превышение размера заголовка).
Технический совет разработчика: Во время отладки интеграций, вебхуков или AJAX-запросов не ограничивайтесь только статусом
400 Bad Requestв консоли – всегда читайте тело ответа (Response body) во вкладке Network браузера или выводите детали валидации на бэкенде. Грамотное возвращение понятных сообщений об ошибках валидации (например, какое поле не прошло проверку) экономит часы во время фронтенд- и API-разработки.