Гайды

Почему форма не отправляется — 3 причины и как проверить каждую

Иллюстрация: письмо из формы улетает мимо почтового ящика

Ты жмёшь «Отправить». Страница моргает, поля очищаются, никакой ошибки. И никакого письма.

Вот что обычно происходит на самом деле: форма не сломана — она отправилась. Просто в никуда. Браузер сделал ровно то, что умеет с формами по умолчанию, а твой код в этом не участвовал.

Разберём три причины по частоте — от самой частой к редкой. Каждую можно проверить за минуту.

Если совсем некогда читать, вот порядок проверки: посмотри адресную строку после нажатия → открой вкладку Network и убедись, что запрос вообще ушёл → выведи в консоль содержимое FormData → и только потом иди на сервер. Три из четырёх поломок ловятся на первых двух шагах.

Причина 1: браузер обработал форму сам

У тега <form> есть поведение по умолчанию, встроенное в браузер с девяностых: собрать поля, уйти на адрес из action и перезагрузить страницу. Если action не указан — перезагрузить текущую, дописав данные в адрес.

Именно поэтому кажется, что «ничего не произошло»: страница просто перерисовалась с нуля.

Как проверить. Нажми «Отправить» и посмотри в адресную строку. Увидел там ?name=Аня&email=... — диагноз подтверждён: данные ушли в URL, а не на сервер.

Второй способ: открой DevTools → вкладка Network, включи галочку Preserve log. Если после нажатия в списке появляется навигация (документ), а не твой запрос, — работает поведение по умолчанию.

Как починить. Отменить его первой строкой обработчика:

function handleSubmit(e) {
  e.preventDefault();   // без этой строки страница перезагрузится
  // дальше твоя отправка
}

<form onSubmit={handleSubmit}>

Частая ошибка рядом: preventDefault есть, но обработчик повешен на кнопку, а не на форму. Тогда отправка по Enter в поле идёт мимо него. Вешай onSubmit на <form> — сработает и клик, и Enter.

Причина 2: у полей нет атрибута name

Это фирменный баг сгенерированных форм. Поля выглядят прекрасно: есть placeholder, есть id, есть классы. А name нет.

Проблема в том, что браузер собирает данные формы именно по name. Нет атрибута — поле в отправку не попадает. Форма уходит пустой, сервер отвечает «заполните обязательные поля», и ты смотришь на заполненные поля в полном недоумении.

Как проверить. Добавь в обработчик одну строку:

console.log([...new FormData(e.target)]);

Пустой массив (или в нём нет части полей) — вот и ответ.

Как починить. Дать name каждому полю, которое должно уехать:

<input type="email" name="email" placeholder="Почта" />

id нужен для связки с <label>, name — для отправки. Это разные вещи, и одно другое не заменяет. Как устроена эта связь элементов — в отдельном разборе.

Причина 3: кнопка не отправляет форму

Кнопка внутри формы по умолчанию считается кнопкой отправки. Но её легко отключить, часто случайно.

  • <button type="button"> — такая кнопка не отправляет ничего. Ставится по привычке или копируется из примера.
  • Кнопка вынесена за пределы <form> — визуально рядом, а к форме отношения не имеет.
  • Работает встроенная валидация: у поля стоит required, оно пустое, и браузер молча блокирует отправку. Если поле при этом скрыто стилями, подсказку «заполните поле» ты не увидишь вообще.

Как проверить. Убери на минуту все required и поставь type="submit" у кнопки. Отправилось — причина найдена, возвращай проверки по одной.

Если отправка уходит, а результата всё равно нет

Значит, дело уже не в форме, а в том, что происходит дальше. Смотри вкладку Network — там виден запрос и ответ.

  • Ответ 404 — неверный адрес обработчика. Опечатка или маршрут не создан.
  • Ответ 405 (Method Not Allowed) — адрес есть, но он не принимает POST. Классика: обработчик написан только под GET.
  • Ошибка CORS — форма на одном домене, обработчик на другом, чужой сервер не разрешил запрос. Это лечится на стороне сервера, разбор здесь.
  • Запрос ушёл, но код дальше не сработал — забытый await у fetch. Отдельная классика, про неё есть почему fetch возвращает undefined.

Порядок отладки всегда один: сначала убедись, что запрос вообще ушёл, и только потом ищи, почему он не понравился серверу.

Почему форма работает локально, а на сайте — нет?

Обычно это адрес обработчика. Локально ты шлёшь на localhost:3000, а в продакшене этот адрес не существует — нужен относительный путь (/api/contact) или адрес из переменных окружения. Второй по частоте вариант — CORS: локально домены совпадали, на бою разошлись.

Нужен ли сервер, чтобы форма работала?

Кто-то должен принять данные, но писать это самому не обязательно. Есть готовые сервисы приёма форм и no-code варианты — как собрать рабочую форму от начала до конца, разобрано в гайде про форму обратной связи.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →