Estrategias de Renderizado (App Router)
Prioridad: P0 (CRÍTICA)
Selecciona la estrategia de renderizado según la frescura de datos y las necesidades de escalado. Consulta la Matriz de Estrategias.
Pautas de Implementación
- SSG (Generación de Sitios Estáticos): Valor predeterminado para App Router. Usa
generateStaticParamspara prerenderizar rutas en tiempo de compilación. Se activa mediantefetchconcache: 'force-cache'. - SSR (Renderizado del Lado del Servidor): Se activa mediante
cookies(),headers()ofetchconcache: 'no-store'. Úsalo para datos personalizados o de alta frescura. - ISR (Regeneración Estática Incremental): Actualiza contenido estático después de la compilación. Usa
revalidate(basado en tiempo) orevalidatePath/revalidateTag(bajo demanda). - Streaming: Usa
Suspensepara envolver componentes asíncronos lentos y evitar que bloqueen la carga inicial de la página. Usaloading.tsxpara esqueletos a nivel de ruta. - PPR (Prerenderizado Parcial): Combina un shell estático con regiones dinámicas en una sola solicitud HTTP. Habilita
ppr: trueennext.config.js. - Estrategias: Elige el renderizado según SEO (SSG/ISR) frente a Interactividad (Cliente) o Personalización (SSR). Utiliza
dynamicParamspara controlar el comportamiento de fallback en rutas no almacenadas en caché. - Hidratación: Evita Errores de Hidratación al no usar valores exclusivos del navegador (
window.innerWidth,Date.now()) en el renderizado inicial. Usa el patrónmountedconuseEffect. - Edge Runtime: Usa
runtime: 'edge'para ejecución global distribuida de baja latencia donde no se requieren las APIs completas de Node.js.
Anti-Patrones
- No uses
awaiten la raíz depage.tsx: Envuelve los componentes lentos en<Suspense>para transmitir. - No uses SSR para contenido estático: Usa SSG o ISR; reserva SSR para datos verdaderamente dinámicos.
- No uses
typeof windowen el renderizado inicial: UsauseEffectpara evitar errores de hidratación.