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

Server Actions vs Route Handlers în Next.js: când alegi fiecare în practică

De Ioana Marinescu, 19 oct. 2026 · 26 vizualizări · 3 like-uri

Postat 19 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!);

export async function POST(req: Request) {
  const body = await req.text();
  const signature = (await headers()).get("stripe-signature")!;

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

    if (event.type === "payment_intent.succeeded") {
      // Procesezi plata asincron fără dependență de sesiunea UI
    }

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

Am văzut multă lume aruncându-se să rescrie toate endpoint-urile vechi de API în Server Actions imediat ce a apărut Next.js 14. E o greșeală clasică de tipul „avem un ciocan nou, hai că totul e cui”.

Server Actions sunt practic apeluri RPC (Remote Procedure Call) strâns legate de ciclul de viață al componentelor React. Route Handlers (app/api/.../route.ts) rămân endpoint-uri HTTP clasice, agnostice de UI. Fiecare rezolvă o problemă diferită, iar granița dintre ele devine evidentă când te lovești de scenarii din lumea reală.

Form submit: Server Actions bat la scor

Aici Server Actions strălucesc fără discuție. La o aplicație de gestiune pentru un depozit, aveam vreo opt formulare de editare pentru stocuri, fiecare legat de un fetch('/api/inventory', { method: 'POST' }) cu stări separate de isLoading, isError și mesaje sincronizate manual.

Când le-am rescris pe Server Actions combinate cu useActionState, am tăiat cam 40% din codul clientului. Nu mai ai nevoie de URL-uri hardcodate, serializarea se face automat, iar cel mai mare câștig este integrarea nativă cu revalidatePath și revalidateTag. Trimiți formularul pe server, muți datele în baza de date, invalidezi cache-ul paginii și React se ocupă singur de refetch și rerender pe server. Fără useEffect, fără librării externe de data fetching pentru o simplă mutație.

Trade-off sincer: dacă ai nevoie de răspunsuri JSON structurate pentru consumatori externi (de exemplu, o aplicație de mobil pe React Native), un Server Action e inutilizabil direct. E gândit strict pentru consum intern în arborele tău de React.

File upload: Atenție la limitele de memorie

Teoretic poți trimite un FormData cu un fișier direct într-un Server Action. Practic, dacă fișierul are mai mult de câțiva megabytes, e o idee proastă.

În primul rând, Server Actions au o limită default de payload (de regulă 1MB pe platforme serverless precum Vercel, deși o poți extinde din next.config.js). În al doilea rând, când trimiți fișierul prin Action, muți tot fluxul binar prin instanța ta de Node, ceea ce omoară memoria containerului dacă ai 50 de useri simultan.

Pentru fișiere mari, abordarea corectă e un Route Handler minuscul care generează un presigned URL de S3 sau Cloudflare R2, iar clientul face PUT direct în bucket. Dacă totuși ai un avatar de 200KB, merge și un Server Action simplu, dar nu-ți baza fluxul de storage masiv pe el.

Webhooks externe: Teritoriul exclusiv Route Handlers

Când Stripe, GitHub sau Twilio trimit o notificare POST pe serverul tău, nu există niciun browser, nicio sesiune React și niciun formular. Nu poți folosi un Server Action pentru asta, punct.

Un webhook are nevoie de un endpoint HTTP veritabil. Trebuie să citești raw body-ul pentru a valida semnătura criptografică (ex: stripe-signature), să răspunzi cu un status code curat 200 OK în mai puțin de două secunde și să trimiți eventual un 400 dacă payload-ul e corupt. Server Actions ascund aceste detalii de transport HTTP sub capotă, motiv pentru care sunt complet incompatibile cu webhook-urile.

Regula practică

Dacă acțiunea pornește dintr-o interacțiune a utilizatorului tău în interfață și vrei să actualizezi cache-ul React imediat după, alege Server Actions. Dacă ai nevoie de un protocol HTTP standard, streaming binar, acces la raw headers/body sau consumatori externi, Route Handlers sunt singura opțiune corectă.

Voi cum ați împărțit logica în proiectele mari pe App Router?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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