Estratégias de Renderização (App Router)
Prioridade: P0 (CRÍTICA)
Escolha a estratégia de renderização com base na necessidade de atualização dos dados e nos requisitos de escalabilidade. Consulte a Matriz de Estratégias.
Diretrizes de Implementação
- SSG (Geração de Sites Estáticos): Padrão para App Router. Use
generateStaticParamspara pré-renderizar rotas em tempo de build. Acionado porfetchcomcache: 'force-cache'. - SSR (Renderização no Servidor): Acionado por
cookies(),headers(), oufetchcomcache: 'no-store'. Use para dados personalizados ou que exigem alta atualização. - ISR (Regeneração Estática Incremental): Atualize conteúdo estático após o build. Use
revalidate(baseado em tempo) ourevalidatePath/revalidateTag(sob demanda). - Streaming: Use
Suspensepara envolver componentes assíncronos lentos e evitar que bloqueiem o carregamento inicial da página. Useloading.tsxpara skeletons no nível da rota. - PPR (Pré-renderização Parcial): Combine um shell estático com regiões dinâmicas em uma única requisição HTTP. Ative
ppr: trueemnext.config.js. - Estratégias: Escolha a renderização com base em SEO (SSG/ISR) vs Interatividade (Cliente) vs Personalização (SSR). Utilize
dynamicParamspara controlar o comportamento de fallback para rotas não armazenadas em cache. - Hidratação: Evite Erros de Hidratação não usando valores exclusivos do navegador (
window.innerWidth,Date.now()) na renderização inicial. Use o padrãouseEffectcommounted. - Edge Runtime: Use
runtime: 'edge'para execução global de baixa latência onde as APIs completas do Node.js não são necessárias.
Anti-Padrões
- Sem
awaitraiz empage.tsx: Envolva componentes lentos em<Suspense>para fazer streaming. - Sem SSR para conteúdo estático: Use SSG ou ISR; reserve SSR para dados verdadeiramente dinâmicos.
- Sem
typeof windowna renderização inicial: UseuseEffectpara evitar erros de hidratação.