v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:08:00.000Z▲ 0 upvotes

Zod на API Routes Next.js: strict, strip і що насправді захищає від зайвих полів

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Яку проблему вирішуємо

Дві атаки, про які зазвичай говорять у зв'язці із суворою валідацією:

  • Mass assignment. Клієнт надсилає {"name":"Ivan","role":"admin"} в ендпоінт оновлення профілю, а сервер робить db.user.update({ data: body }). Поле role проходить до бази.
  • Prototype pollution. У тілі є ключ __proto__ або constructor.prototype, і код рекурсивно зливає його в об'єкт через самописний deepMerge, змінюючи прототип Object.

Обидві вразливості виникають не через відсутність .strict(), а через те, що сервер використовує сире тіло запиту. Якщо ви валідуєте через Zod і далі працюєте тільки з результатом parse, зайві ключі туди не потраплять навіть без strict: за замовчуванням z.object їх відкидає (режим strip).

Три режими об'єкта

import { z } from "zod";

const Base = { name: z.string().min(1).max(100) };

z.object(Base).parse({ name: "a", role: "admin" });
// { name: "a" } — role молча удалён

z.object(Base).strict().parse({ name: "a", role: "admin" });
// ZodError: unrecognized key "role"

z.object(Base).passthrough().parse({ name: "a", role: "admin" });
// { name: "a", role: "admin" } — опасно для входных данных

У Zod 4 ті ж режими доступні як окремі конструктори z.strictObject({...}) та z.looseObject({...}); методи .strict() та .passthrough() збережені для сумісності. Виберіть один стиль проекту.

Навіщо тоді strict? Він перетворює мовчазне видалення на явну помилку. Клієнт, який опечатався в імені поля (emial замість email), отримує 400 із зазначенням ключа, а не «успішне» збереження без email. Для внутрішніх API та форм це заощаджує годинник налагодження.

Шаблон обробника

// app/api/profile/route.ts
import { z } from "zod";
import { NextResponse } from "next/server";
import { getSession } from "@/lib/auth";
import { db } from "@/lib/db";

const Address = z.strictObject({
  city: z.string().max(80),
  street: z.string().max(120),
});

const UpdateProfile = z.strictObject({
  name: z.string().trim().min(1).max(100).optional(),
  email: z.email().optional(),          // в Zod 3: z.string().email()
  address: Address.optional(),
});

export async function PATCH(req: Request) {
  const session = await getSession();
  if (!session) return NextResponse.json({ error: "unauthorized" }, { status: 401 });

  let json: unknown;
  try {
    json = await req.json();
  } catch {
    return NextResponse.json({ error: "invalid JSON" }, { status: 400 });
  }

  const parsed = UpdateProfile.safeParse(json);
  if (!parsed.success) {
    return NextResponse.json(
      { error: "validation", issues: parsed.error.issues.map(i => ({ path: i.path, message: i.message })) },
      { status: 400 }
    );
  }

  // только parsed.data, никогда json
  const user = await db.user.update({ where: { id: session.userId }, data: parsed.data });
  return NextResponse.json({ id: user.id, name: user.name, email: user.email });
}

Деталі, які часто упускають:

  • `strict` не рекурсивний. Вкладений z.object всередині строгого об'єкта залишається в режимі strip. Тому Address оголошено окремо як суворий.
  • `req.json()` кидає виняток на некоректному JSON. Без try/catch клієнт отримає 500 замість 400.
  • `safeParse` замість `parse` — щоб не ловити виняток для звичайних помилок користувача.
  • Відповідь також фільтрується. Повертайте явний набір полів, а не весь об'єкт користувача з хешем пароля.

Query-параметри та форми

Все, що приходить з searchParams і FormData, - рядки. Використовуйте приведення:

const ListQuery = z.strictObject({
  page: z.coerce.number().int().min(1).default(1),
  limit: z.coerce.number().int().min(1).max(100).default(20),
  q: z.string().max(200).optional(),
});

const query = ListQuery.safeParse(Object.fromEntries(new URL(req.url).searchParams));

Object.fromEntries втрачає повторювані параметри (?tag=a&tag=b). Якщо вони потрібні, збирайте масив через searchParams.getAll("tag") окремо.

Як діагностувати

  • Клієнт скаржиться на 400 після релізу мобільного додатку: нова версія шле додаткове поле, а схема сувора. Подивіться issues у відповіді – там буде шлях до ключа.
  • Поле «не зберігається», помилок немає: схема не строга, і ключ називається інакше, ніж очікуєте. Увімкніть strict і повторіть запит.
  • У логах __proto__ у ключах – сканер шукає prototype pollution. Якщо ви використовуєте parsed.data, це шум; перевірте, чи немає у коді злиття сирих об'єктів.

Коли strict заважає

Вебхуки зовнішніх сервісів (платіжні системи, месенджери) регулярно додають нові поля. Сувора схема на них перетворить невинне оновлення провайдера на відмову обробки. Для таких входів використовуйте режим strip та описуйте лише потрібні поля. Те ж саме для публічних API зі зворотною сумісністю: строга схема на старих версіях ендпоінтів може ламати клієнтів, які відправляють поля з нових версій.

Обсуждение (0)

Ещё на vbcd4u.com