eduardweb.
Server ActionsIntermediar#server-actions#nextjs#react#fullstack

Server Actions vs API Routes în Next.js: când merită fiecare și unde m-am fript

De Cristian Barbu, 28 oct. 2026 · 23 vizualizări · 2 like-uri

Postat 28 oct. 2026
typescript
import { headers } from "next/headers";
import { NextResponse } from "next/server";
import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

// Webhook-urile au NEVOIE de Route Handlers pentru raw body parsing
export async function POST(req: Request) {
  const body = await req.text();
  const signature = (await headers()).get("stripe-signature");

  if (!signature) {
    return NextResponse.json({ error: "Missing signature" }, { status: 400 });
  }

  try {
    const event = stripe.webhooks.constructEvent(
      body,
      signature,
      process.env.STRIPE_WEBHOOK_SECRET!
    );

    if (event.type === "payment_intent.succeeded") {
      // logica de business aici
    }

    return NextResponse.json({ received: true }, { status: 200 });
  } catch (err) {
    return NextResponse.json({ error: "Webhook verification failed" }, { status: 400 });
  }
}

Anul trecut am migrat bucăți bune dintr-un CRM intern cu vreo 8.000 de utilizatori zilnici de la clasicele API routes (Route Handlers) la Server Actions. Entuziasmul inițial a fost mare, dar după câteva săptămâni ne-am lovit de niște limitări evidente. Nu tot ce zboară în Next.js se pretează la Server Actions, chiar dacă documentația oficială le împinge agresiv în față.

Form submit: unde Server Actions strălucesc

Dacă ai un formular clasic — adăugare comentariu, update de profil, setări de cont — Server Actions îți elimină lejer 40% din codul de legătură. Scapi complet de fetch, de stările manuale de loading împrăștiate prin useState și de rute separate de tip /api/users/update.

Combinația de useActionState cu zod și revalidatePath funcționează impecabil. Ai mutația direct legată de componentă, iar cache-ul din Next.js se invalidează instant, fără să mai configurezi TanStack Query sau să jonglezi cu tag-uri manuale.

Trade-off-ul? Cuplarea este totală. Dacă peste 6 luni ai nevoie să expui același formular sau mutație către o aplicație de mobil (React Native/Flutter), acțiunea aia server-side nu te ajută cu nimic. Nu e un endpoint REST, e un RPC intern gândit strict pentru interfața ta web.

File upload: capcana memoriei și a limitelor serverless

Aici am văzut cele mai multe implementări proaste. Dacă muți un avatar de 300KB, trimiterea unui FormData direct într-un Server Action e comodă și merge din prima.

Problema apare când utilizatorii încep să urce documente de 20-50MB. Când trimiți un fișier masiv printr-un Server Action, Next.js îl trece ca payload prin instanța ta serverless sau Node.js. Pe Vercel, de exemplu, te lovești rapid de limita dură de 4.5MB pentru body-ul request-ului. În plus, dacă ai Docker pe un VPS ieftin, transformarea fișierelor mari în memorie o să-ți blocheze event loop-ul.

Pentru fișiere mari, soluția sănătoasă rămâne un API route dedicat (sau chiar un Server Action foarte scurt) care doar generează un URL presemnat de S3/Cloudflare R2, iar clientul face PUT direct în bucket. Nu trece traficul greu prin procesul de Next.js.

Webhook-uri third-party: exclusiv Route Handlers

Am văzut juniori întrebând pe forum dacă pot procesa un webhook de Stripe sau Clerk printr-un Server Action. Răspunsul scurt: exclusiv NU.

Server Actions sunt gândite să fie apelate dintr-un context de browser React, bazându-se pe header-e specifice și adesea pe cookie-uri de sesiune. Stripe sau GitHub habar n-au de protocolul intern Next.js. Ei fac un simplu POST cu un payload JSON sau raw text către un URL public.

Pentru orice înseamnă webhook extern, ai nevoie de un Route Handler curat (app/api/webhooks/.../route.ts). Acolo ai acces direct la request-ul brut (req.text()), verifici semnătura criptografică și întorci manual status 200 sau 400.

Regula mea simplă e asta: dacă acțiunea pornește dintr-un click de utilizator în interfață, Server Action e prima opțiune; dacă cererea vine din afara aplicației sau trebuie consumată de clienți non-React, Route Handler rămâne sfânt.

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.