Capítulo 245 de 456

staticGeneration*

Core Idea

Grupo de opções experimentais que ajustam o processo de Static Generation para casos de uso avançados (retry, concorrência, distribuição de trabalho entre workers).

Key Concepts

  • experimental.staticGenerationRetryCount: número de tentativas antes de falhar o build quando a geração de uma página falha.
  • experimental.staticGenerationMaxConcurrency: número máximo de páginas processadas por worker.
  • experimental.staticGenerationMinPagesPerWorker: número mínimo de páginas processadas antes de iniciar um novo worker.

Code Examples

import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
  experimental: {
    staticGenerationRetryCount: 1,
    staticGenerationMaxConcurrency: 8,
    staticGenerationMinPagesPerWorker: 25,
  },
}
export default nextConfig
  • O que demonstra: as três opções configuradas juntas para tunar builds com muitas páginas estáticas.

Key Takeaways

  1. Use para builds grandes: ajustar staticGenerationMaxConcurrency/MinPagesPerWorker controla o paralelismo entre workers de geração estática.
  2. staticGenerationRetryCount é a única alavanca para resiliência a falhas transitórias na geração de página.