Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Μάθετε σε βάθος τις οδηγίες use cache, cacheLife και revalidatePath με πρακτικά παραδείγματα.
Το Next.js 16 εισάγει έναν θεμελιώδη επανασχεδιασμό στο σύστημα προσωρινής αποθήκευσης (caching). Απομακρύνεται από το παλιό, σιωπηρό caching των fetch() και καθιερώνει την ρητή (explicit) δήλωση caching μέσω της οδηγίας 'use cache' και του API cacheLife.
Προαπαιτούμενο: οι οδηγίες
'use cache',cacheLifeκαιcacheTagείναι χαρακτηριστικά Cache Components. Χωρίς τη σημαία, δεν εφαρμόζονται:
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
partialPrefetching: true,
}
export default nextConfigΜε το Cache Components ενεργό, το Partial Prerendering (PPR) είναι η προεπιλεγμένη συμπεριφορά — δεν χρειάζεται ξεχωριστή σημαία.
Όταν μια συνάρτηση ή ένα component φέρει την οδηγία 'use cache', το Next.js 16 καταγράφει τα ορίσματά της ως cache keys και αποθηκεύει το αποτέλεσμα:
// lib/data/courses.ts
import { cacheLife, cacheTag } from 'next/cache'
export async function getPublishedCourses() {
'use cache'
cacheLife('hours') // Διατήρηση στην προσωρινή μνήμη για ώρες
cacheTag('courses-catalog')
// Ακριβό ερώτημα βάσης δεδομένων PostgreSQL
const courses = await db.select().from(coursesTable).where(eq(coursesTable.published, true))
return courses
}Το cacheLife αντικαθιστά τις στατικές παραμέτρους revalidate: 3600 με σημασιολογικά (semantic) προφίλ:
// Προκαθορισμένα προφίλ του Next.js 16 (τιμές από τα επίσημα docs):
cacheLife('default') // stale: 5m, revalidate: 15m, expire: never
cacheLife('seconds') // stale: 30s, revalidate: 1s, expire: 1m
cacheLife('minutes') // stale: 5m, revalidate: 1m, expire: 1h
cacheLife('hours') // stale: 5m, revalidate: 1h, expire: 1d
cacheLife('days') // stale: 5m, revalidate: 1d, expire: 1wk
cacheLife('weeks') // stale: 5m, revalidate: 1wk, expire: 30d
cacheLife('max') // stale: 5m, revalidate: 30d, expire: 1yΜπορείτε επίσης να ορίσετε προσαρμοσμένα προφίλ στο next.config.ts:
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
partialPrefetching: true,
cacheLife: {
marketData: {
stale: 30, // 30 δευτερόλεπτα
revalidate: 60, // ανανέωση στο παρασκήνιο
expire: 300, // διαγραφή μετά από 5 λεπτά
},
},
}
export default nextConfigΑντί να εκκαθαρίζετε ολόκληρες διαδρομές με το revalidatePath, το σύγχρονο μοτίβο συνδέει δεδομένα με semantic tags:
// actions/admin.ts
'use server'
import { revalidateTag, revalidatePath } from 'next/cache'
export async function updateCourseAction(courseId: string, data: FormData) {
// 1. Ενημέρωση στη βάση δεδομένων
await db.update(coursesTable).set({ title: data.get('title') }).where(eq(coursesTable.id, courseId))
// 2. Στοχευμένη εκκαθάριση μόνο των εξαρτώμενων caches.
// Σημασιολογία SWR: το tag σημαδεύεται stale — ο επόμενος επισκέπτης
// μπορεί να δει την παλιά τιμή ενώ η ανανέωση τρέχει στο παρασκήνιο.
revalidateTag('courses-catalog', 'max')
revalidateTag(`course-${courseId}`, 'max')
// 3. Προαιρετικό path revalidation για άμεση ανανέωση του διαχειριστικού UI
revalidatePath('/admin')
return { success: true }
}Σε αρχιτεκτονική Partial Prerendering (PPR), το εξωτερικό κέλυφος και τα δεδομένα καταλόγου τυλίγονται σε cache components, ενώ οι δυναμικές πληροφορίες χρήστη (π.χ. avatar, υπόλοιπο credits) παραδίδονται ασύγχρονα (αναλυτικά: Mastering Next.js 16 Partial Prerendering (PPR)):
// app/courses/page.tsx
import { Suspense } from 'react'
import { getPublishedCourses } from '@/lib/data/courses'
import { UserGreeting } from '@/components/user-greeting'
export default async function CoursesPage() {
const courses = await getPublishedCourses() // Άμεση ανάκτηση από cache (0ms)
return (
<div className="container py-8">
{/* Δυναμικό hole με streaming */}
<Suspense fallback={<div className="h-8 w-40 animate-pulse bg-muted rounded" />}>
<UserGreeting />
</Suspense>
{/* Στατικό προ-αποθηκευμένο κέλυφος μαθημάτων */}
<div className="grid gap-6 mt-8">
{courses.map((c) => (
<CourseCard key={c.id} course={c} />
))}
</div>
</div>
)
}| Μηχανισμός | Επίπεδο Εφαρμογής | Ιδανική Περίπτωση Χρήσης |
|---|---|---|
'use cache' | Συνάρτηση / Component | Ακριβά DB queries, υπολογισμοί τιμών, external API calls |
cacheLife('...') | Εντός 'use cache' | Ορισμός TTL (Time-To-Live) και stale-while-revalidate ορίων |
cacheTag('...') | Εντός 'use cache' | Σημασιολογική ομαδοποίηση για εύκολο invalidation |
revalidateTag('...', 'max') | Server Action | Σήμανση tag ως stale (SWR)· άμεση ακύρωση θέλει updateTag ή expire: 0 |
revalidatePath('...') | Server Action | Εκκαθάριση ολόκληρης της διαδρομής (χρήσιμο σε CRUD forms) |
await updateCourseAction(courseId, formData)
revalidateTag('courses-catalog', 'max')Αμέσως μετά, επισκέπτης ανοίγει τον κατάλογο που διαβάζει το tag courses-catalog μέσα σε 'use cache'. Ποια τιμή μπορεί να δει — τη φρέσκια ή την παλιά;
'use cache' και θέλει cacheComponents: true στο next.config.ts.cacheLife('hours') και ομαδοποίηση με cacheTag('courses-catalog').revalidateTag σε σημασιολογία SWR, όπου ο επόμενος επισκέπτης μπορεί να δει stale τιμή όσο τρέχει η ανανέωση.Suspense, ενώ το revalidatePath καθαρίζει ολόκληρη διαδρομή.