التخزين المؤقت في Next.js 15: الجلب بدون ذاكرة التخزين المؤقت الافتراضية وrevalidateTag وunstable_cache
ما الذي تغير عند الانتقال إلى 15
في Next.js 14، تم تخزين fetch في مكونات الخادم مؤقتًا بشكل افتراضي. في 15 تم عكس هذا السلوك:
- لا يتم تخزين
fetchمؤقتًا ما لم تحدد بشكل صريحcache: 'force-cache'أوnext.revalidate. - لا يتم تخزين معالجات GET في معالجات الطريق مؤقتًا بشكل افتراضي.
- لم تعد ذاكرة التخزين المؤقت لجهاز توجيه العميل للصفحات تحتوي على مقاطع مدتها 30 ثانية:
staleTimeللصفحات الديناميكية صفر.
قصة نموذجية بعد التحديث: زاد التحميل على واجهة برمجة التطبيقات أو قاعدة البيانات لأن كل طلب صفحة يسترد البيانات الآن. أو العكس: لا يبدو أن البيانات مخزنة مؤقتًا، لكن الصفحة لا تزال تعرض البيانات القديمة.
اعتراض: لا يوجد جلب ذاكرة تخزين مؤقت، لكن الصفحة ثابتة
إذا كان المسار لا يستخدم واجهات برمجة التطبيقات الديناميكية (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 - العمر الاحتياطي. الآلية الرئيسية هي إبطال العلامة في وقت تغيير البيانات.
إعادة التحقق من صحة العلامة وإعادة التحقق من صحة المسار
// 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، لكن الطلب إلى Postgres عبر ORM ليس كذلك. يوجد 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 build && next start، وليس فيnext dev: في وضع التطوير، تعمل ذاكرة التخزين المؤقت بشكل مختلف.
##أخطاء شائعة
- توقع أن يقوم
revalidateTagبتحديث البيانات المستلمة بدون علامة. العلامة ملزمة في وقت الطلب. - إبطال من مكون العميل. الوظائف من
next/cacheتعمل فقط على الخادم. - عدة حالات
next startخلف الموازن. توجد ذاكرة التخزين المؤقت الافتراضية في نظام الملفات لكل مثيل، ولن يؤثرrevalidateTagعلى أحدهما على الآخرين. أنت بحاجة إلىcacheHandlerعام (على سبيل المثال، في Redis). - تخزين البيانات الشخصية تحت مفتاح مشترك. إذا كانت الإجابة تعتمد على المستخدم، فيجب أن يكون معرف المستخدم جزءًا من المفتاح، ومن الأفضل عدم تخزين هذه البيانات مؤقتًا على الإطلاق.
عندما لا تكون هناك حاجة إلى ذاكرة التخزين المؤقت
من الأسهل ترك لوحات الإدارة والحسابات الشخصية والصفحات التي تحتوي على بيانات في الوقت الفعلي ديناميكية تمامًا. يتم تبرير ذاكرة التخزين المؤقت حيث تتم قراءة نفس البيانات من قبل العديد من المستخدمين أكثر من تغييرها.