Как проверять пользовательский ввод — 6 шагов, которые ИИ пропускает

Попроси агента «добавить форму» — и он добавит. С required в разметке, с красивой подсветкой ошибок. Выглядит проверенным.
А потом кто-то отправит запрос мимо формы — курлом, из консоли, из своего скрипта — и обнаружит, что на сервере проверок нет вообще. Ни одной.
Разберём по шагам, как сделать нормально. Сразу честная рамка: валидация — не основная защита от инъекций. OWASP пишет прямо: её «не следует использовать как основной метод предотвращения XSS, SQL-инъекций и других атак». От них спасают параметризованные запросы и правильный вывод. Валидация нужна для другого: чтобы в базу не попадал мусор, а логика не падала на пустоте.
Шаг 1. Признай, что клиент врать умеет
Правило одно, и оно не обсуждается. OWASP: валидация «должна выполняться на стороне сервера до того, как данные попадут в функции приложения, потому что любую проверку на JavaScript в браузере атакующий может обойти».
required, maxlength, type="email" — это удобство для человека. Снимаются двумя кликами в инструментах разработчика. Проверка на сервере — единственная, которая считается.
Шаг 2. Опиши схему вместо россыпи if
Не пиши двадцать проверок руками. Опиши, как выглядят правильные данные, одним объектом. Это и документация, и проверка сразу.
import { z } from "zod";
const Feedback = z.object({
email: z.email(),
topic: z.enum(["баг", "идея", "оплата"]),
message: z.string().trim().min(10).max(2000),
rating: z.number().int().min(1).max(5),
}).strict();
Две детали, ради которых это писалось.
z.enum([...])— это и есть список разрешённого. Не «запретим плохие темы», а «есть ровно три, всё остальное — отказ»..strict()— запрещает лишние ключи. Иначе кто-нибудь пришлёт{"role": "admin"}вместе с отзывом, а твой код возьмёт и запишет объект в базу целиком.
Шаг 3. Проверь на входе, до всякой логики
Одна проверка на самом краю — и дальше по коду ты работаешь с данными, в которых уверен.
export async function POST(req) {
const result = Feedback.safeParse(await req.json());
if (!result.success) {
return Response.json({ error: "Проверь поля формы" }, { status: 400 });
}
const data = result.data; // дальше — только чистые данные
}
safeParse не бросает исключение, а возвращает результат — поэтому обработка ошибки читается спокойно. Про сам формат данных, если он пока новый, — в разборе, что такое JSON.
Шаг 4. Сначала нормализуй, потом проверяй
Порядок важнее, чем кажется. Если проверить раньше, чем привести к общему виду, ты пропустишь дубли и странности.
- Обрежь пробелы по краям —
.trim()в схеме выше. - Приведи почту к нижнему регистру. Иначе
[email protected]и[email protected]заведут два аккаунта. - Нормализуй Unicode. У буквы «й» есть два разных представления. Одно и то же имя перестанет совпадать само с собой:
const name = raw.normalize("NFC").trim();
Кстати, про буквы: OWASP советует для свободного текста не запрещать символы по списку, а нормализовать и разрешать категории символов. Иначе первым пострадает человек с фамилией О'Брайен — апостроф у него настоящий, и почему-то именно он попадает под «фильтр от SQL-инъекций».
Шаг 5. Поставь границы там, где их обычно нет
Самое частое, что забывает и агент, и человек, — верхний предел.
- Длина текста. Без
max()кто-нибудь пришлёт мегабайт в поле «сообщение». - Размер тела запроса. Ставится на сервере или прокси, не в коде обработчика.
- Диапазон чисел.
quantity: -5в корзине — это возврат денег, если проверки нет. - Число запросов. Валидная форма, отправленная тысячу раз, тоже проблема — про это отдельно в лимитах на запросы.
Про почту отдельная рекомендация OWASP, и она снимает много боли: не пытайся написать идеальную регулярку. Сделай базовую проверку, а окончательный ответ узнаешь, когда почтовый сервер письмо примет или отвергнет.
Отдельная история — файлы. Расширению в имени и заголовку Content-Type верить нельзя: оба приходят от клиента, и оба меняются в одну строчку. Тип определяют по первым байтам самого файла, а имя на диске генерируют своё:
const name = crypto.randomUUID() + ".webp"; // а не file.originalname
Так у тебя не появится на сервере файл с именем, которое придумал незнакомый человек.
Шаг 6. Ответь понятно — и не отдай лишнего
Ошибка должна помочь человеку и ничего не рассказать про твой сервер.
// человеку
{ "error": "Сообщение — от 10 до 2000 символов" }
// а не так
{ "error": "PG::StringDataRightTruncation at users.message" }
Текст исключения от базы — это бесплатная подсказка о твоей схеме. Подробности пиши в логи, наружу отдавай короткое человеческое объяснение.
Что получится
Пройди шесть шагов — и у тебя появится ровно одна точка, где данные становятся доверенными. До неё — «что-то пришло». После — объект известной формы.
Проверь себя быстро: отправь запрос мимо формы, курлом.
curl -X POST https://твой-сайт.ру/api/feedback \
-H "Content-Type: application/json" \
-d '{"email":"нет","message":"кк","role":"admin"}'
Должен вернуться 400 и короткое объяснение. Если вернулся 200 — валидация живёт только в браузере, а значит её нет.
Проверять на клиенте вообще не нужно?
Нужно, но не ради безопасности. Проверка в браузере даёт мгновенный ответ и экономит человеку отправку формы вслепую. Просто она ничего не гарантирует — сервер обязан проверить всё заново.
Достаточно ли валидации, чтобы не бояться инъекций?
Нет, и это главное недоразумение вокруг темы. Валидация отсекает мусор, а от инъекций защищают параметризованные запросы к базе и правильный вывод в HTML. Считай это двумя разными задачами, которые просто живут рядом.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





