Caching di Next.js 15: ambil tanpa cache default, validasi ulangTag, dan stable_cache
Apa yang berubah saat pindah ke 15
Di Next.js 14, fetch di komponen server di-cache secara default. Pada usia 15 tahun, perilaku ini dibalik:
fetchtidak di-cache kecuali Anda secara eksplisit menentukancache: 'force-cache'ataunext.revalidate.- GET handler di Route Handler tidak di-cache secara default.
- Cache Router Klien untuk halaman tidak lagi menampung segmen 30 detik:
staleTimeuntuk halaman dinamis adalah nol.
Kisah umum setelah pembaruan: beban pada API atau database meningkat karena setiap permintaan halaman sekarang mengambil data. Atau sebaliknya: data sepertinya tidak di-cache, tetapi halaman masih menampilkan yang lama.
Perangkap: tidak ada cache pengambilan, tetapi halamannya statis
Jika rute tidak menggunakan API dinamis (cookies(), headers(), searchParams, connection()), Next.js akan melakukan pra-render di next build. fetch yang tidak di-cache akan dieksekusi satu kali pada waktu pembuatan, dan hasilnya akan tetap ada dalam HTML selamanya. Dalam mode pengembangan, semuanya terlihat dinamis, sehingga masalah hanya muncul di produksi.
Periksa - keluaran next build: ○ berarti rute statis, ƒ berarti dinamis.
Secara eksplisit membuat rute menjadi dinamis:
// 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} />;
}Atau sebaliknya, buat rute statis diperbarui secara berkala melalui export const revalidate = 300 di file halaman.
Caching pengambilan dengan tag
// 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 - cadangan seumur hidup. Mekanisme utamanya adalah pembatalan tag pada saat perubahan data.
validasi ulangTag dan validasi ulangPath
// 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");
}Perbedaan antar fungsi:
revalidateTag(tag)menandai semua entri cache data dengan tag ini sebagai basi, tidak peduli di halaman mana entri tersebut digunakan.revalidatePath(path)membuat rute tertentu tidak valid. Untuk segmen dinamis, templat dan jenisnya ditunjukkan:revalidatePath("/blog/[slug]", "page")- semua halaman artikel,revalidatePath("/", "layout")- semuanya secara umum.
Tag lebih tepat: Anda membuat data menjadi tidak valid, daripada menebak-nebak di URL mana data tersebut muncul. revalidatePath berguna bila data tidak masuk melalui fetch (misalnya, dari database tanpa pembungkus).
Kedua fungsi tersebut berfungsi di Tindakan Server dan Penangan Rute. Untuk webhook dari CMS, buat Route Handler dengan pemeriksaan rahasia yang memanggil revalidateTag.
stable_cache untuk kueri ke database
fetch di-cache melalui next, tetapi permintaan ke Postgres melalui ORM tidak. Ada unstable_cache untuk itu:
// 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"] }
);Batasan: Anda tidak dapat memanggil cookies() dan headers() di dalam suatu fungsi - meneruskan segala sesuatu yang bergantung pada permintaan sebagai argumen. Hasilnya harus diserialkan ke JSON, sehingga objek Date akan dikembalikan sebagai string. Awalan unstable_ berarti API dapat berubah. Di Next.js 16, model caching telah berubah lagi (direktif use cache dan berubah menjadi revalidateTag), jadi periksa dokumentasi untuk versi Anda saat memutakhirkan.
Bagaimana memahami apa yang di-cache
- 1.Aktifkan login kueri
next.config.ts:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;Konsol server akan menampilkan baris yang menunjukkan cache hit atau miss untuk setiap fetch.
- 2.Untuk
next startyang dihosting sendiri, lihat header responsx-nextjs-cache:HIT,STALEatauMISSuntuk halaman dari cache.
- 3.Periksa pada build
next build && next start, bukan padanext dev: dalam mode pengembangan, cache berperilaku berbeda.
Kesalahan umum
- Harapkan
revalidateTagmemperbarui data yang diterima tanpa tag. Tag terikat pada saat permintaan. - Tidak valid dari komponen klien. Fungsi dari
next/cachehanya berfungsi di server. - Beberapa instance
next startdi belakang penyeimbang. Cache default ada di sistem file setiap instance, danrevalidateTagdi satu instance tidak akan memengaruhi yang lain. Anda memerlukancacheHandlergenerik (misalnya, di Redis). - Cache data pribadi di bawah kunci umum. Jika jawabannya tergantung pada pengguna, ID pengguna harus menjadi bagian dari kunci, dan lebih baik tidak menyimpan data tersebut dalam cache sama sekali.
Ketika cache tidak diperlukan
Lebih mudah untuk membiarkan panel admin, akun pribadi, dan halaman dengan data real-time sepenuhnya dinamis. Cache dibenarkan jika data yang sama lebih sering dibaca oleh banyak pengguna daripada diubah.