Pular para o conteúdo
Breaking change

Next.js 16.4.0

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
40 de 129
Nesta página

Resumo

O Next.js 16.4.0 estabiliza controles para definir qual conteúdo será preparado durante a navegação e verificar se uma rota conserva a renderização estática. O Turbopack inclui alterações no cache e nos arquivos gerados. Você pode comparar o build da aplicação e a navegação após a revalidação, pois a publicação também corrige a atualização do conteúdo armazenado. Aplicações que adotaram os nomes experimentais das canaries precisam revisar seus imports e configurações.

Novidades

  • Next.js 16.4.0 — Etapas de navegação: navigation() e prefetch() recebem nomes sem o prefixo unstable_. As funções permitem adiar a preparação de conteúdo para a navegação ou para o prefetch explícito, respectivamente.
  • Next.js 16.4.0 — Rotas estáticas: ensureStatic é estabilizado com as opções shell, prefetch e navigation. Você pode verificar a parte estática da rota ou exigir que a navegação inteira permaneça estática.
  • Next.js 16.4.0 — Atualização por agentes: next upgrade inclui o percurso de atualização assistida por agente. Os avisos de atualização ficam habilitados por padrão e conservam os processos de desenvolvimento e build durante a apresentação das opções.
  • Next.js 16.4.0 — Aplicações novas: o create-next-app habilita Cache Components por padrão e acrescenta a configuração de feedback dos agentes. O feedback respeita a desativação de telemetria e não funciona no ambiente de integração contínua.
  • Next.js 16.4.0 — Análise dos arquivos gerados: next analyze recebe comparação entre builds e uma tabela de módulos. A skill next-bundle-optimizer utiliza informações das rotas e dos chunks, incluindo carregamento assíncrono e workers.

Melhorias

  • Next.js 16.4.0 — Cache do Turbopack: a compressão por família e a compactação modificam o armazenamento em disco. O coletor de lixo também remove tarefas transitórias e descarta tarefas ausentes durante a restauração.
  • Next.js 16.4.0 — Atualização em desenvolvimento: o HMR do servidor utiliza carregamento adiado. O runtime compartilhado do Turbopack fica habilitado por padrão e os builds utilizam nomes reduzidos para as exportações.
  • Next.js 16.4.0 — Loaders: o Turbopack acompanha arquivos e diretórios utilizados como dependências dos loaders do Webpack. Os loaders recebem suporte adicional à resolução e à leitura entre raízes do sistema de arquivos.
  • Next.js 16.4.0 — Dependências e atualização: eslint-config-next aceita ESLint 10. O percurso de atualização permite conservar as versões de React e ESLint e utiliza o gerenciador de pacotes declarado pela aplicação.

Correções

  • Next.js 16.4.0 — Revalidação do cache: a publicação corrige conteúdo desatualizado após navegar, revalidações duplicadas de use cache e o encaminhamento de revalidateTag a handlers personalizados com perfis diferentes. Entradas de ISR (regeneração estática incremental) conservam seu prazo entre instâncias e reinícios.
  • Next.js 16.4.0 — Navegação e respostas: alterações superficiais da URL preservam os parâmetros do cliente sem provocar um fallback desnecessário de Suspense. A pré-renderização conserva o status HTTP e os limites de erro, incluindo o processamento sob demanda.
  • Next.js 16.4.0 — Exportação estática: os diretórios de saída configurados são preservados. Assets estáticos imutáveis recebem suporte com output: 'export'.
  • Next.js 16.4.0 — Imagens e compilação: next/image recusa imagens vazias e respostas internas fora da faixa 2xx. O Turbopack corrige a resolução por links simbólicos encadeados e a recuperação do HMR após perder a conexão.

Breaking changes

  • Next.js 16.4.0 — Nomes utilizados nas canaries: aplicações que importaram unstable_navigation ou unstable_prefetch precisam utilizar navigation ou prefetch. A configuração de segmento unstable_ensureStatic utiliza o nome ensureStatic nesta publicação.
  • Next.js 16.4.0 — Configuração dos avisos: a opção agentUpgrade perde o valor true. Aplicações que utilizaram esse valor nas canaries precisam selecionar uma política como security ou latest, ou desativar os avisos com false.

Ponto de Atenção

A versão é estável, mas nem todos os recursos incluídos têm esse estado. forbidden() e unauthorized() conservam a condição experimental após a reversão registrada nas notas. A compatibilidade com React 18 no Pages Router é depreciada, sem anúncio de remoção nesta publicação.

Teste sugerido: em uma cópia da aplicação, compare o build e uma navegação após revalidateTag com o resultado da versão anterior. Para uma rota que deve permanecer estática, configure ensureStatic e confira o diagnóstico ao incluir conteúdo dinâmico incompatível com o nível escolhido.

Aplicações que vieram de uma canary precisam conferir também os imports e agentUpgrade. Quando houver exportação estática com diretório personalizado, confirme a preservação do destino.

Notas da versão

O release oficial do Next.js 16.4.0 foi publicado em 07/10/2026 às 06h03 no fuso America/New_York. O arquivo bruto também reúne as canaries .62 e .63, cujas publicações permanecem no diário de 06/10. Este relato cobre a versão estável.

Versões anteriores

    • Next.js 16.5.0-canary.1

      O Next.js 16.5.0-canary.1 modifica a criação dos snapshots de tarefas do Turbopack.

      Pre-release
    • Next.js 16.4.0-canary.63

      O Next.js 16.4.0-canary.63 preserva diretórios configurados durante a exportação estática e reverte a estabilização de forbidden() e unauthorized().

      Breaking change
    • Next.js 16.4.0-canary.62

      O Next.js 16.4.0-canary.62 amplia a análise dos arquivos gerados e mantém o desenvolvimento e a compilação em execução durante os avisos de atualização.

      Pre-release
    • Next.js 16.4.0-canary.61

      O Next.js 16.4.0-canary.61 estabiliza forbidden() e unauthorized() dentro da linha canary e acrescenta compatibilidade com ESLint 10 ao eslint-config-next.

      Pre-release
    • Next.js 16.4.0-canary.60

      O Next.js 16.4.0-canary.60 padroniza as cores usadas para mostrar variações no analisador de bundles.

      Pre-release
    • Next.js 16.4.0-canary.59

      O Next.js 16.4.0-canary.59 corrige a exibição desnecessária do fallback de Suspense durante uma atualização de URL e a suspensão dos parâmetros no cliente durante alterações rasas de navegação.

      Pre-release

Versões posteriores

    • Next.js 16.5.0-canary.7

      O Next.js 16.5.0-canary.7 restaura a opção experimental de utilizar o webpack instalado na aplicação.

      Pre-release
    • Next.js 16.5.0-canary.6

      O Next.js 16.5.0-canary.6 expõe um caminho público para a transformação de imagens e modifica o agrupamento dos arquivos produzidos pelo Turbopack.

      Pre-release
    • Next.js 16.5.0-canary.5

      O Next.js 16.5.0-canary.5 ajusta testes de deploy do repositório e corrige a expectativa de resposta do Google Tag Manager.

      Pre-release
    • Next.js 16.5.0-canary.4

      O Next.js 16.5.0-canary.4 corrige o envio de telemetria com Node.js 24 e remove avisos do Turbopack que não orientavam uma ação útil.

      Pre-release
    • Next.js 16.5.0-canary.3

      O Next.js 16.5.0-canary.3 utiliza ESLint 10 nas aplicações novas do create-next-app e amplia a inspeção dos traces do Turbopack.

      Pre-release
    • Next.js 16.5.0-canary.2

      O Next.js 16.5.0-canary.2 identifica as falhas de download de fontes pelo Turbopack com uma mensagem específica.

      Pre-release
Ver todas as 129 versões do Next.js
Histórico de versões