v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:02:00.000Z▲ 0 upvotes

Next.js 15의 캐싱: 기본 캐시 없이 가져오기, revalidateTag 및 불안정한_cache

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

15로 이동하면서 달라진 점

Next.js 14에서는 서버 구성 요소의 fetch가 기본적으로 캐시되었습니다. 15에서는 이 동작이 반전되었습니다.

  • fetch는 cache: 'force-cache' 또는 next.revalidate를 명시적으로 지정하지 않는 한 캐시되지 않습니다.
  • 경로 핸들러의 GET 핸들러는 기본적으로 캐시되지 않습니다.
  • 페이지용 클라이언트 라우터 캐시는 더 이상 30초 세그먼트를 보유하지 않습니다. 동적 페이지용 staleTime는 0입니다.

업데이트 후의 일반적인 이야기: 이제 모든 페이지 요청이 데이터를 검색하기 때문에 API 또는 데이터베이스의 로드가 증가했습니다. 또는 그 반대의 경우도 있습니다. 데이터가 캐시되지 않은 것 같지만 페이지에는 여전히 이전 데이터가 표시됩니다.

트랩: 가져오기 캐시는 없지만 페이지는 정적입니다.

경로가 동적 API(cookies(), headers(), searchParams, connection())를 사용하지 않는 경우 Next.js는 이를 next build에서 미리 렌더링합니다. 캐시되지 않은 fetch는 빌드 시 한 번 실행되며 결과는 HTML에 영원히 유지됩니다. 개발 모드에서는 모든 것이 동적으로 보이므로 문제는 프로덕션에서만 나타납니다.

확인 - 출력 next build: ○는 정적 경로를 의미하고, ƒ는 동적 경로를 의미합니다.

명시적으로 경로를 동적으로 만듭니다.

// app/dashboard/page.tsx
import { connection } from "next/server";

export default async function Page() {
  await connection(); // дальше всё выполняется на каждый запрос
  const stats = await fetch("https://api.example.com/stats").then((r) => r.json());
  return <Stats data={stats} />;
}

또는 그 반대의 경우 페이지 파일의 export const revalidate = 300를 통해 정적 경로를 주기적으로 업데이트합니다.

태그를 사용한 캐싱 가져오기

// lib/data/posts.ts
export async function getPosts() {
  const res = await fetch("https://cms.example.com/posts", {
    next: { revalidate: 3600, tags: ["posts"] },
  });
  if (!res.ok) throw new Error(`cms ${res.status}`);
  return res.json() as Promise<Post[]>;
}

export async function getPost(slug: string) {
  const res = await fetch(`https://cms.example.com/posts/${slug}`, {
    next: { revalidate: 3600, tags: ["posts", `post:${slug}`] },
  });
  if (res.status === 404) return null;
  return res.json() as Promise<Post>;
}

revalidate: 3600 - 남은 수명. 주요 메커니즘은 데이터 변경 시 태그 무효화입니다.

revalidateTag 및 revalidatePath

// app/admin/posts/actions.ts
"use server";
import { revalidatePath, revalidateTag } from "next/cache";

export async function publishPost(slug: string) {
  await requireEditor();          // проверка прав — первой строкой
  await cms.publish(slug);
  revalidateTag(`post:${slug}`);  // точечно: одна статья
  revalidateTag("posts");         // списки, где она может быть
  revalidatePath("/sitemap.xml");
}

기능의 차이점:

  • revalidateTag(tag)는 사용된 페이지에 관계없이 이 태그가 있는 모든 데이터 캐시 항목을 오래된 것으로 표시합니다.
  • revalidatePath(path)는 특정 경로를 무효화합니다. 동적 세그먼트의 경우 템플릿과 유형이 표시됩니다. revalidatePath("/blog/[slug]", "page") - 기사의 모든 페이지, revalidatePath("/", "layout") - 일반적인 모든 것.

태그는 더 정확합니다. 즉, 어떤 URL이 표시되는지 추측하는 대신 데이터를 무효화합니다. revalidatePath는 데이터가 fetch를 통해 제공되지 않은 경우(예: 래퍼가 없는 데이터베이스에서) 편리합니다.

두 기능 모두 서버 작업 및 경로 처리기에서 작동합니다. CMS의 웹훅의 경우 revalidateTag를 호출하는 비밀 검사를 사용하여 경로 처리기를 만듭니다.

데이터베이스에 대한 쿼리를 위한 불안정한 캐시

fetch는 next를 통해 캐시되지만 ORM을 통한 Postgres에 대한 요청은 그렇지 않습니다. unstable_cache가 있습니다.

// lib/data/stats.ts
import { unstable_cache } from "next/cache";
import { db } from "@/lib/db";

export const getCategoryCounts = unstable_cache(
  async (locale: string) => {
    const { rows } = await db.query(
      "SELECT category, count(*)::int AS n FROM threads WHERE locale = $1 GROUP BY category",
      [locale]
    );
    return rows;
  },
  ["category-counts"],               // часть ключа; аргументы добавляются автоматически
  { revalidate: 600, tags: ["threads"] }
);

제한 사항: 함수 내에서 cookies() 및 headers()를 호출할 수 없습니다. 요청에 따라 달라지는 모든 항목을 인수로 전달하세요. 결과는 JSON으로 직렬화되어야 하므로 Date 객체는 문자열로 반환됩니다. unstable_ 접두사는 API가 변경될 수 있음을 의미합니다. Next.js 16에서는 캐싱 모델이 다시 변경되었으므로(use cache 지시어가 revalidateTag로 변경됨) 업그레이드할 때 해당 버전에 대한 설명서를 확인하세요.

캐시된 내용을 이해하는 방법

  1. 1.next.config.ts에서 쿼리 로깅을 활성화합니다.
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;

서버 콘솔에는 각 fetch에 대한 캐시 적중 또는 누락을 나타내는 줄이 표시됩니다.

  1. 2.자체 호스팅 next start의 경우 캐시의 페이지에 대한 응답 헤더 x-nextjs-cache: HIT, STALE 또는 MISS를 참조하세요.
  1. 3.next dev가 아닌 next build && next start 빌드를 확인하세요. 개발 모드에서는 캐시가 다르게 동작합니다.

일반적인 실수

  • revalidateTag는 태그 없이 수신된 데이터를 업데이트할 것으로 예상됩니다. 태그는 요청 시 바인딩됩니다.
  • 클라이언트 구성 요소에서 무효화합니다. next/cache의 기능은 서버에서만 작동합니다.
  • 밸런서 뒤에 있는 여러 인스턴스next start. 기본 캐시는 각 인스턴스의 파일 시스템에 있으며, 하나의 revalidateTag는 다른 인스턴스에 영향을 주지 않습니다. 일반 cacheHandler가 필요합니다(예: Redis의 경우).
  • 공통 키로 개인 데이터를 캐시합니다. 대답이 사용자에 따라 달라지는 경우 사용자 ID는 키의 일부여야 하며 이러한 데이터를 전혀 캐시하지 않는 것이 좋습니다.

캐시가 필요하지 않은 경우

관리자 패널, 개인 계정, 실시간 데이터가 포함된 페이지를 완전히 동적으로 유지하는 것이 더 쉽습니다. 많은 사용자가 동일한 데이터를 변경하는 것보다 더 자주 읽는 경우 캐시가 정당화됩니다.

Обсуждение (0)

Ещё на vbcd4u.com