Arquitectura de Caché
Prioridad: P1 (ALTA)
Next.js tiene 4 capas de caché distintas. Comprenderlas previene errores de datos obsoletos.
Directrices de Implementación
- Estándar Next.js 15+: Usa
fetchconrevalidate: numberocache: 'force-cache'para llamadas a API. Usaunstable_cacheo la nueva'use cache'(experimental) para almacenes de datos personalizados. - Capas: Distingue entre Caché de Datos (persistente entre solicitudes) y Memorización de Solicitudes (específica del ciclo de vida de React). Usa
cache()de React para deduplicar fetchs dentro de un solo renderizado. - Invalidación: Usa
revalidatePath('/')después de mutaciones orevalidateTag('tag-name')para una purga granular de la caché. - Caché del Cliente: Comprende la Caché del Router (en memoria en el cliente) y su vida útil de 30s-min. Límpiala usando
router.refresh(). - Activos Estáticos: Aprovecha
generateStaticParamspara prerrenderizar rutas estáticas en tiempo de compilación. Usa ISR (Regeneración Estática Incremental) para contenido que se actualiza periódicamente. - Streaming: Combina
Suspensecon disparadoresfetchpara evitar que los datos lentos bloqueen el renderizado completo de la página. - Next.js 16+: Favorece
'use cache'ycacheLife()sobrerevalidate: numbercuando estén disponibles para un almacenamiento en caché determinista.
| Capa | Dónde | Control |
|---|---|---|
| Memorización de Solicitudes | Servidor | React cache() |
| Caché de Datos | Servidor | 'use cache', revalidateTag |
| Caché de Ruta Completa | Servidor | Prerrenderizado Estático |
| Caché del Router | Cliente | router.refresh() |
Detalles de Implementación
Consulta Componentes de Caché y PPR para obtener detalles sobre la generación de claves, restricciones de clausura y estrategias de invalidación.
Anti-Patrones
- No uses
unstable_cacheen Next.js 16+: Usa la directiva'use cache'concacheLife()en su lugar. - No uses
router.refresh()para datos del servidor: PrefiererevalidateTag()para una invalidación de caché dirigida. - No almacenes en caché datos específicos del usuario a nivel de ruta: Envuelve los datos personales en
<Suspense>con'use cache'. - No uses caché de larga duración sin etiquetas: Asigna
cacheTag()para un control de invalidación detallado.