Під час роботи з веб-сайтами або 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-розробки.