Ir para o conteúdo
Promovaweb

Cache, consultas e revalidação no Next.js

StayCloudVPS Agêntica

O mesmo ambiente do SetupVibe, agora numa VPS

Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

Criar minha VPS na StayCloud

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O cache reutiliza resultados para evitar repetir parte do trabalho numa visita. Você define quais consultas podem ser reaproveitadas e como substituir o conteúdo depois de uma alteração.

Sumário da página

  1. Uma consulta e sua reutilização
  2. O tempo de validade acompanha o conteúdo
  3. Cache Components tem configuração própria
  4. Depois da gravação, a tela precisa acompanhar
  5. Réplicas precisam combinar a atualização

Uma consulta e sua reutilização

Uma página de catálogo precisa consultar nomes, preços e disponibilidade. Fazer essa leitura a cada visita pode repetir trabalho que não mudou. O cache permite reaproveitar um resultado conforme o comportamento configurado. Essa reutilização exige uma definição sobre por quanto tempo a resposta pode continuar válida e como ela será substituída depois de uma edição.

O Next.js oferece mecanismos para consultar serviços e bancos a partir de Server Components. Uma chamada fetch pode obter conteúdo de uma API. Um cliente de banco pode buscar registros diretamente. A configuração e as APIs usadas determinam quando a resposta pode ser reutilizada em outras visitas.

A documentação consultada informa que chamadas fetch não ficam em cache por padrão. Ela também distingue a reutilização de chamadas idênticas durante uma renderização da manutenção de resultados para outras requisições. Essas duas formas de evitar trabalho repetido têm alcance diferente. Uma consulta executada uma vez numa árvore de componentes pode voltar a executar na visita seguinte.

O tempo de validade acompanha o conteúdo

Um texto institucional pode aceitar atualização depois de algum tempo. A disponibilidade de um produto pode exigir uma leitura mais recente. A compra de um cliente precisa considerar a sessão e o acesso permitido. Você relaciona a política de cache ao conteúdo apresentado, sem tratar todos esses registros como uma lista pública equivalente.

A revalidação por tempo permite reaproveitar um resultado por um período definido pela aplicação. A invalidação por evento responde a uma alteração conhecida, como a edição de um produto. O framework oferece APIs para esses comportamentos. A escolha do momento de atualização depende da necessidade de mostrar uma resposta nova e do trabalho que será repetido.

Revalidar um caminho e revalidar uma tag são formas de identificar conteúdo afetado. O caminho aponta para uma parte da navegação. A tag relaciona resultados que compartilham um assunto definido pelo projeto. O uso precisa corresponder às consultas reais: invalidar um nome que nenhum resultado utiliza deixa o conteúdo esperado no estado anterior.

  1. Consulta

    A página solicita os produtos que pode apresentar.

  2. Reutilização

    Um resultado elegível atende a visita conforme a política de cache.

  3. Alteração

    A edição invalida ou atualiza o conteúdo relacionado.

  4. Nova leitura

    A interface recebe a representação atualizada.

Consultar, reutilizar e invalidar são partes diferentes do caminho até o conteúdo atualizado.

Cache Components tem configuração própria

A documentação atual apresenta Cache Components e a diretiva use cache para declarar partes reutilizáveis. Essa configuração participa da composição entre conteúdo preparado antecipadamente e trechos calculados durante a requisição. A reutilização vale para conteúdo que a sessão atual pode compartilhar, como um catálogo público. As APIs disponíveis e as restrições precisam ser lidas na versão usada pelo projeto.

Cookies e outras informações da requisição têm tratamento específico nessa composição. Um catálogo público e uma tela privada não devem compartilhar um resultado apenas porque usam o mesmo componente visual. O identificador do cliente e a autorização da consulta precisam continuar corretos na execução real. O teste deve incluir sessões diferentes para detectar uma resposta atribuída à pessoa errada.

Ao revisar uma aplicação, identifique primeiro quais recursos de cache estão habilitados. Uma explicação sobre fetch numa versão anterior pode não descrever o comportamento atual. O nome do framework permanece, mas os padrões e as APIs evoluem. A versão instalada, a configuração e as notas oficiais formam a referência para interpretar um resultado antigo na tela.

Depois da gravação, a tela precisa acompanhar

Uma Server Action pode alterar um produto e acionar revalidação. O banco pode aceitar a gravação antes de a interface refletir o preço novo. A aplicação precisa relacionar a alteração à consulta que alimenta aquela página. Sem essa ligação, você pode receber uma confirmação de sucesso e continuar vendo o valor anterior.

Uma interface também pode manter estado no navegador. Atualizar o resultado no servidor e manter uma lista antiga num componente cliente são problemas diferentes. A navegação e o cache do framework participam dessa experiência, junto com o estado local definido pelo projeto. Você precisa observar qual representação está sendo exibida depois da operação.

A conferência útil acompanha um produto concreto. O preço é alterado, a resposta da operação é recebida e a página é consultada novamente. Outra sessão pode precisar ver o mesmo valor público. Uma tela privada deve continuar restrita ao cliente correto. Essa leitura relaciona o cache à informação que realmente importa para a aplicação.

Réplicas precisam combinar a atualização

No self-hosting, várias instâncias podem ter cópias locais de conteúdo reutilizável. Uma invalidação observada por uma instância precisa chegar às outras para atualizar a resposta anterior. A documentação apresenta o tratamento de armazenamento de cache e a coordenação necessária quando a aplicação roda em múltiplos processos ou containers.

A plataforma de hospedagem pode oferecer recursos para essa coordenação. Na sua infraestrutura, você confere quais mecanismos estão presentes e como uma versão nova recebe o cache. O teste precisa passar pelo endereço público e alcançar o conjunto de instâncias usado em produção.

O hub de deploy e stack relaciona essa necessidade ao servidor Node.js, ao Docker e à Vercel. O objetivo é reconhecer o conteúdo reutilizado, o evento que o atualiza e a resposta que chega à pessoa depois dessa atualização. As perguntas frequentes respondem as dúvidas mais comuns sobre cache e consultas.