eduardweb.
DeploymentIntermediar#seo#nextjs#typescript#app-router

Cum configurezi corect generateMetadata și JSON-LD în Next.js 16 fără bătăi de cap

De Liliana Ghiță, 24 oct. 2026 · 23 vizualizări · 3 like-uri

Postat 24 oct. 2026
typescript
import { cache } from 'react';
import type { Metadata } from 'next';

// Deduplicare automată pe durata cererii curente
const getProduct = cache(async (id: string) => {
  return db.product.findUnique({ where: { id } });
});

export async function generateMetadata({
  params,
}: { params: Promise<{ id: string }> }): Promise<Metadata> {
  const { id } = await params;
  const product = await getProduct(id);

  if (!product) return { title: 'Produs negăsit' };

  return {
    title: `${product.name} | Magazinul Meu`,
    description: product.description.slice(0, 155),
    openGraph: {
      title: product.name,
      images: [{ url: `/products/${id}/opengraph-image` }],
    },
  };
}

Am migrat recent un magazin online de nișă cu vreo 14.000 de SKU-uri pe Next.js 16 și am dat rapid cu capul de pragul de sus al SEO-ului. Dacă vrei meta tag-uri dinamice, imagini Open Graph generate pe loc și JSON-LD valid fără să-ți explodeze baza de date de query-uri redundante, mecanismul din App Router cere puțină atenție.

Nu e complicat, dar sunt două-trei capcane clasice în care pică multă lume.

Capcana query-urilor dublate între metadata și pagină

Cea mai mare problemă când treci la generateMetadata dinamic este că această funcție rulează separat de componenta principală Page. Mulți cred că dacă apelează baza de date sau un API în ambele locuri, Next.js știe nativ să unească apelurile.

Realitatea e nuanțată: Next.js deduplică nativ doar apelurile făcute cu fetch(). Dacă folosești Prisma, Drizzle sau un client intern de SDK (de exemplu Supabase sau Stripe), serverul tău va executa query-ul de două ori per vizită: o dată pentru <head> și încă o dată pentru conținutul paginii. La 8k vizitatori unici pe zi, baza de date începe să gâfâie aiurea.

Soluția e simplă dar des ignorată: React.cache. Învelești funcția de fetch de date din DB în cache() din pachetul react. Astfel, instanța de cerere păstrează rezultatul pe durata ciclului de render și scazi latența TTFB cu lejer 120-180ms.

Dynamic Open Graph Images: merită efortul?

Pentru share-uri pe LinkedIn, Twitter sau Slack, imaginile dinamice fac o diferență masivă la CTR. În Next.js 16 ai suport excelent pentru fișiere de tip opengraph-image.tsx direct în folderul rutei, folosind motorul ImageResponse.

Aici apare însă un trade-off serios. ImageResponse randează un markup simplificat (o bucată de JSX transformată în SVG și apoi în PNG via resvg/Satori). E fantastic că poți genera carduri unice cu prețul produsului și stocul în timp real, dar generarea asta mănâncă CPU. Dacă ai sute de share-uri concomitente pe un VPS micuț de 2 vCPU, procesorul stă în 100%.

Sfatul meu: dacă produsele nu își schimbă detaliile la fiecare oră, setează neapărat headere agresive de cache (s-maxage) pentru ruta de imagine sau descarcă greul pe un CDN precum Cloudflare.

Structured Data JSON-LD fără bibelouri

Mulți încearcă să bage JSON-LD tot prin obiectul returnat de generateMetadata. API-ul Next.js nu e gândit să expună direct noduri de script custom în metadata de tip other: {} fără să facă escaping agresiv, lucru care sparge validarea Google.

Cea mai curată și robustă metodă rămâne injectarea unui tag <script type="application/ld+json"> direct în layout-ul sau pagina respectivă. Da, folosești dangerouslySetInnerHTML, dar atâta timp cât serializezi un obiect generat de tine pe server (folosind JSON.stringify()), e complet sigur.

Verifică schema rezultată în Rich Results Test de la Google. În proiectul nostru, adăugarea datelor structurate complete (Product, AggregateRating, Offer) a crescut click-urile organice cu aproape 22% în doar două săptămâni de la reindexare.

Voi cum abordați generarea de OG images pe proiecte mari: mergeți pe runtime cu @vercel/og sau preferați să le generați la build time / asincron pe un worker separat?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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