Next.js 15 ішінде кэштеу: әдепкі кэшсіз алу, revalidateTag және unstable_cache
15-ке көшкенде не өзгерді
Next.js 14 ішінде сервер құрамдастарында fetch әдепкі бойынша кэштелген. 15-те бұл мінез-құлық өзгерді:
fetchcache: '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.
next.config.tsжүйесінде сұрауды тіркеуді қосыңыз:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;Сервер консолі әрбір fetch үшін кэш соққысын немесе жіберіп алғанын көрсететін жолдарды көрсетеді.
- 2.Өздігінен орналастырылған
next startүшінx-nextjs-cacheжауап тақырыбын қараңыз:HIT,STALEнемесе кэштегі беттер үшінMISS.
- 3.
next devемес,next build && next startқұрастыруын тексеріңіз: әзірлеу режимінде кэш басқаша әрекет етеді.
Жалпы қателер
- Тегсіз алынған деректерді жаңарту үшін
revalidateTagкүтіңіз. Тег сұрау кезінде байланыстырылады. - Клиент компонентінен жарамсыз.
next/cacheфункциялары тек серверде жұмыс істейді. - Балансизатордың артында бірнеше даналар
next start. Әдепкі кэш әрбір дананың файлдық жүйесінде және біреуіндегіrevalidateTagбасқаларына әсер етпейді. Сізге жалпыcacheHandlerқажет (мысалы, Redis жүйесінде). - Жеке деректерді ортақ кілт астында кэштеу. Жауап пайдаланушыға байланысты болса, пайдаланушы идентификаторы кілттің бөлігі болуы керек және мұндай деректерді мүлде кэштемеген дұрыс.
Кэш қажет болмаған кезде
Әкімші панелдерін, жеке тіркелгілерді және нақты уақыттағы деректері бар беттерді толығымен динамикалық қалдыру оңайырақ. Бірдей деректер өзгертілгеннен гөрі көп пайдаланушылар жиі оқитын болса, кэш ақталады.