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

Next.js 15-da keshlash: standart keshsiz, revalidateTag va unstable_cachesiz olish

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

15 ga o'tishda nima o'zgardi

Next.js 14 da server komponentlaridagi fetch sukut boʻyicha keshlangan. 15 yilda bu xatti-harakat o'zgartirildi:

  • fetch keshda saqlanmaydi, agar cache: 'force-cache' yoki next.revalidate aniq belgilanmaguncha.
  • Route Handlers-dagi GET ishlov beruvchilari sukut bo'yicha keshda saqlanmaydi.
  • Sahifalar uchun Client Router keshi endi 30 soniyali segmentlarni saqlamaydi: dinamik sahifalar uchun staleTime nolga teng.

Yangilanishdan keyingi odatiy voqea: API yoki ma'lumotlar bazasidagi yuk ortdi, chunki har bir sahifa so'rovi endi ma'lumotlarni oladi. Yoki aksincha: ma'lumotlar keshlanganga o'xshamaydi, lekin sahifa hali ham eskisini ko'rsatadi.

Tuzoq: keshni olib kelmaydi, lekin sahifa statik

Agar marshrutda dinamik API ishlatilmasa (cookies(), headers(), searchParams, connection()), Next.js uni next build da oldindan koʻrsatadi. Keshlanmagan fetch qurilish vaqtida bir marta bajariladi va natija HTMLda abadiy qoladi. Rivojlanish rejimida hamma narsa dinamik ko'rinadi, shuning uchun muammo faqat ishlab chiqarishda paydo bo'ladi.

Tekshirish - chiqish next build: ○ statik marshrutni, ƒ dinamikani bildiradi.

Marshrutni aniq dinamik qiling:

// 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} />;
}

Yoki aksincha, sahifa faylidagi export const revalidate = 300 orqali statik marshrutni vaqti-vaqti bilan yangilab turing.

Teglar bilan olib kehlash

// 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 - zaxira muddati. Asosiy mexanizm - ma'lumotlarni o'zgartirish vaqtida tegni bekor qilish.

revalidateTag va 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");
}

Funktsiyalar orasidagi farq:

  • revalidateTag(tag) qaysi sahifalarda ishlatilishidan qat'i nazar, ushbu teg bilan barcha ma'lumotlar keshidagi yozuvlarni eskirgan deb belgilaydi.
  • revalidatePath(path) muayyan marshrutni bekor qiladi. Dinamik segment uchun shablon va tur ko'rsatilgan: revalidatePath("/blog/[slug]", "page") - maqolalarning barcha sahifalari, revalidatePath("/", "layout") - umuman hamma narsa.

Teglar aniqroq: siz qaysi URL manzillarida paydo bo'lishini taxmin qilish o'rniga, ma'lumotlarni bekor qilasiz. revalidatePath maʼlumotlar fetch orqali kelmaganda qulay (masalan, oʻramsiz maʼlumotlar bazasidan).

Ikkala funktsiya ham Server Actions va Route Handlers-da ishlaydi. CMS-dan veb-huk uchun, revalidateTag ga qo'ng'iroq qiladigan maxfiy tekshiruv bilan Marshrutni ishlov beruvchini yarating.

Ma'lumotlar bazasiga so'rovlar uchun ## beqaror_kesh

fetch next orqali keshlangan, ammo ORM orqali Postgresga so‘rov yo‘q. Buning uchun unstable_cache mavjud:

// 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"] }
);

Cheklovlar: funktsiya ichida cookies() va headers() ga qo'ng'iroq qila olmaysiz - so'rovga bog'liq bo'lgan hamma narsani argument sifatida uzating. Natija JSONga ketma-ketlashtirilishi kerak, shuning uchun Date ob'ektlari satrlar sifatida qaytariladi. unstable_ prefiksi API oʻzgarishi mumkinligini bildiradi. Next.js 16 da keshlash modeli yana oʻzgardi (use cache direktivasi va revalidateTag ga oʻzgaradi), shuning uchun yangilashda versiyangiz uchun hujjatlarni tekshiring.

Keshlangan narsalarni qanday tushunish mumkin

  1. 1.next.config.ts soʻroviga kirishni yoqing:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;

Server konsoli har bir fetch uchun kesh urishi yoki o'tkazib yuborilganligini ko'rsatadigan qatorlarni ko'rsatadi.

  1. 2.O'z-o'zidan joylashtirilgan next start uchun x-nextjs-cache javob sarlavhasiga qarang: keshdagi sahifalar uchun HIT, STALE yoki MISS.
  1. 3.next dev da emas, balki next build && next start tuzilishini tekshiring: ishlab chiqish rejimida kesh boshqacha ishlaydi.

Umumiy xatolar

  • Tegsiz olingan maʼlumotlarni yangilash uchun revalidateTag kuting. Teg so'rov vaqtida bog'langan.
  • Mijoz komponentidan bekor qilish. next/cache funksiyalari faqat serverda ishlaydi.
  • Balanslashtiruvchining orqasida bir nechta misollar next start. Standart kesh har bir misolning fayl tizimida va biridagi revalidateTag boshqalarga ta'sir qilmaydi. Sizga umumiy cacheHandler kerak (masalan, Redis-da).
  • Shaxsiy ma'lumotlarni umumiy kalit ostida keshlash. Agar javob foydalanuvchiga bog'liq bo'lsa, foydalanuvchi identifikatori kalitning bir qismi bo'lishi kerak va bunday ma'lumotlarni umuman keshlash yaxshi emas.

Kesh kerak bo'lmaganda

Administrator panellari, shaxsiy hisoblar va real vaqtda maʼlumotlarga ega sahifalarni butunlay dinamik qoldirish osonroq. Kesh bir xil ma'lumotlar o'zgartirilganidan ko'ra ko'p foydalanuvchilar tomonidan tez-tez o'qiladigan joyda oqlanadi.

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

Ещё на vbcd4u.com