Cache

Essas regras identificam padrões que ignoram o CDN da Vercel e o cache ISR, forçando renderização desnecessária no lado do servidor e aumentando os custos de computação.

Comportamento por versão

Os diagnósticos de cache se adaptam à versão major detectada do Next.js:

• Next.js 15: os avisos enfatizam que fetch e handlers GET não são armazenados em cache por padrão.
• Next.js 16+: os avisos priorizam a orientação sobre Cache Components ("use cache", tags de cache, revalidação direcionada).
• Outras/versões desconhecidas: os avisos usam orientação agnóstica ao framework para políticas de cache.

nextjs-no-side-effect-in-get-handler

Detecta route handlers GET que contêm efeitos colaterais (mutação de cookies, headers ou chamadas ao banco de dados) ou estão em segmentos de rota mutáveis como /logout, /signout, /delete, etc.

Por que importa: Requisições GET podem ser acionadas por prefetching e são vulneráveis a CSRF. Efeitos colaterais em handlers GET também impedem o cache.

// app/api/logout/route.ts
export async function GET() {
  cookies().delete("session");
  return Response.json({ ok: true });
}

// app/api/logout/route.ts
export async function POST() {
  cookies().delete("session");
  return Response.json({ ok: true });
}

Segmentos de rota mutáveis detectados: logout, log-out, signout, sign-out, unsubscribe, delete, remove, revoke, cancel, deactivate.

vercel-no-force-dynamic

Detecta páginas com export const dynamic = "force-dynamic".

Por que importa: force-dynamic força a renderização no lado do servidor em cada requisição, ignorando completamente o cache de página completa.

export const dynamic = "force-dynamic";

export default function Page() { ... }

export const revalidate = 3600;

export default function Page() { ... }

vercel-no-no-store-fetch

Detecta chamadas fetch com cache: "no-store" ou revalidate: 0.

Por que importa: Essas opções desativam o cache completamente, aumentando a largura de banda sem cache e os custos de computação em cada requisição.

const data = await fetch(url, { cache: "no-store" });

const data = await fetch(url, {
  next: { revalidate: 3600 },
});

vercel-missing-cache-policy

Detecta route handlers GET sem nenhuma configuração de cache explícita — sem headers Cache-Control, sem export revalidate e sem export dynamic.

Por que importa: Sem uma política de cache explícita, as respostas podem perder oportunidades de cache no CDN, causando requisições repetidas à origem.

export async function GET() {
  const data = await fetchData();
  return Response.json(data);
}

export const revalidate = 3600;

export async function GET() {
  const data = await fetchData();
  return Response.json(data);
}

vercel-prefer-get-static-props

Detecta rotas do Pages Router usando getServerSideProps.

Por que importa: getServerSideProps executa em cada requisição. Trocar para getStaticProps (com ISR opcional) cacheia as páginas no CDN e reduz a computação no servidor.

vercel-get-static-props-consider-isr

Detecta getStaticProps sem um valor de retorno revalidate.

Por que importa: Sem revalidate, todas as páginas são construídas no momento do deploy. Para sites grandes, isso desacelera drasticamente as builds. O ISR gera páginas sob demanda e as cacheia.

export async function getStaticProps() {
  const data = await fetchData();
  return {
    props: { data },
    revalidate: 3600,
  };
}