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

Next.js 15 ішінде кэштеу: әдепкі кэшсіз алу, revalidateTag және unstable_cache

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

15-ке көшкенде не өзгерді

Next.js 14 ішінде сервер құрамдастарында fetch әдепкі бойынша кэштелген. 15-те бұл мінез-құлық өзгерді:

  • fetch cache: 'force-cache' немесе next.revalidate анық көрсетпейінше, кэштелмейді.
  • Бағдар өңдеуіштеріндегі GET өңдеушілері әдепкі бойынша кэштелмейді.
  • Беттерге арналған Client Router Cache бұдан былай 30 секундтық сегменттерді ұстамайды: staleTime динамикалық беттер үшін нөлге тең.

Жаңартудан кейінгі әдеттегі оқиға: API немесе дерекқордағы жүктеме өсті, себебі әрбір бет сұрауы енді деректерді шығарады. Немесе керісінше: деректер кэштелмеген сияқты, бірақ бет бұрынғысын көрсетеді.

Trap: кэшті алу жоқ, бірақ бет статикалық

Егер бағыт динамикалық 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 жүйесінде).
  • Жеке деректерді ортақ кілт астында кэштеу. Жауап пайдаланушыға байланысты болса, пайдаланушы идентификаторы кілттің бөлігі болуы керек және мұндай деректерді мүлде кэштемеген дұрыс.

Кэш қажет болмаған кезде

Әкімші панелдерін, жеке тіркелгілерді және нақты уақыттағы деректері бар беттерді толығымен динамикалық қалдыру оңайырақ. Бірдей деректер өзгертілгеннен гөрі көп пайдаланушылар жиі оқитын болса, кэш ақталады.

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

Ещё на vbcd4u.com