Arquitetura de Cache
Prioridade: P1 (ALTA)
Next.js tem 4 camadas distintas de cache. Entendê-las previne bugs de dados obsoletos.
Diretrizes de Implementação
- Padrão Next.js 15+: Use
fetchcomrevalidate: numberoucache: 'force-cache'para chamadas de API. Useunstable_cacheou o novo'use cache'(experimental) para armazenamentos de dados personalizados. - Camadas: Diferencie entre Cache de Dados (persistente entre requisições) e Memoização de Requisições (específico do ciclo de vida do React). Use
cache()do React para desduplicar buscas dentro de uma única renderização. - Invalidação: Use
revalidatePath('/')após mutações ourevalidateTag('tag-name')para limpeza granular de cache. - Cache do Cliente: Entenda o Cache do Roteador (em memória no cliente) e sua vida útil de 30s-min. Limpe-o usando
router.refresh(). - Ativos Estáticos: Aproveite
generateStaticParamspara pré-renderizar rotas estáticas no momento da construção. Use ISR (Regeneração Estática Incremental) para conteúdo que é atualizado periodicamente. - Streaming: Combine
Suspensecom gatilhos defetchpara evitar que dados lentos bloqueiem a renderização completa da página. - Next.js 16+: Prefira
'use cache'ecacheLife()em vez derevalidate: numberquando disponível, para um cache determinístico.
| Camada | Onde | Controle |
|---|---|---|
| Memoização de Requisições | Servidor | cache() do React |
| Cache de Dados | Servidor | 'use cache', revalidateTag |
| Cache de Rota Completa | Servidor | Pré-renderização Estática |
| Cache do Roteador | Cliente | router.refresh() |
Detalhes de Implementação
Veja Componentes de Cache e PPR para geração detalhada de chaves, restrições de closure e estratégias de invalidação.
Anti-Padrões
- Sem
unstable_cacheno Next.js 16+: Use a diretiva'use cache'comcacheLife()em vez disso. - Sem
router.refresh()para dados do servidor: PrefirarevalidateTag()para limpeza direcionada de cache. - Sem cache de dados específicos do usuário no nível de rota: Envolva dados pessoais em
<Suspense>com'use cache'. - Sem cache de longa duração sem tags: Atribua
cacheTag()para controle de invalidação refinado.