Bộ nhớ đệm trong Next.js 15: tìm nạp không có bộ đệm mặc định, xác nhận lạiTag và không ổn định_cache
Điều gì đã thay đổi khi chuyển sang 15
Trong Next.js 14, fetch trong các thành phần máy chủ được lưu vào bộ nhớ đệm theo mặc định. Vào năm 15, hành vi này đã bị đảo ngược:
fetchkhông được lưu vào bộ nhớ đệm trừ khi bạn chỉ định rõ ràngcache: 'force-cache'hoặcnext.revalidate.- Trình xử lý GET trong Trình xử lý tuyến không được lưu vào bộ đệm theo mặc định.
- Bộ đệm ẩn bộ định tuyến máy khách cho các trang không còn giữ các phân đoạn 30 giây:
staleTimeđối với các trang động bằng 0.
Một câu chuyện điển hình sau khi cập nhật: tải trên API hoặc cơ sở dữ liệu đã tăng lên vì hiện tại mọi yêu cầu của trang đều truy xuất dữ liệu. Hoặc ngược lại: dữ liệu tưởng như không được lưu vào bộ nhớ đệm nhưng trang vẫn hiển thị dữ liệu cũ.
Bẫy: không có bộ đệm tìm nạp, nhưng trang ở trạng thái tĩnh
Nếu tuyến đường không sử dụng API động (cookies(), headers(), searchParams, connection()), Next.js sẽ kết xuất trước tuyến đường đó tại next build. fetch không được lưu vào bộ nhớ đệm sẽ được thực thi một lần tại thời điểm xây dựng và kết quả sẽ tồn tại mãi mãi trong HTML. Trong chế độ phát triển, mọi thứ đều có vẻ động nên vấn đề chỉ xuất hiện trong quá trình sản xuất.
Kiểm tra - đầu ra next build: ○ nghĩa là tuyến tĩnh, ƒ nghĩa là động.
Rõ ràng làm cho tuyến đường năng động:
// 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} />;
}Hoặc ngược lại, tạo tuyến tĩnh được cập nhật định kỳ qua export const revalidate = 300 trong tệp trang.
Tìm nạp bộ nhớ đệm bằng thẻ
// 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 - tuổi thọ dự phòng. Cơ chế chính là vô hiệu hóa thẻ tại thời điểm thay đổi dữ liệu.
xác nhận lạiTag và xác nhận lạiĐường dẫn
// 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");
}Sự khác biệt giữa các chức năng:
revalidateTag(tag)đánh dấu là cũ tất cả các mục trong bộ nhớ đệm dữ liệu có thẻ này, bất kể chúng được sử dụng trên trang nào.revalidatePath(path)vô hiệu hóa tuyến đường cụ thể. Đối với phân đoạn động, mẫu và loại được chỉ định:revalidatePath("/blog/[slug]", "page")- tất cả các trang của bài viết,revalidatePath("/", "layout")- mọi thứ nói chung.
Thẻ chính xác hơn: bạn vô hiệu hóa dữ liệu thay vì đoán xem nó xuất hiện ở URL nào. revalidatePath thuận tiện khi dữ liệu không đi qua fetch (ví dụ: từ cơ sở dữ liệu không có trình bao bọc).
Cả hai chức năng đều hoạt động trong Hành động máy chủ và Trình xử lý tuyến đường. Đối với webhook từ CMS, hãy tạo Trình xử lý tuyến bằng kiểm tra bí mật gọi revalidateTag.
không ổn định_cache cho các truy vấn tới cơ sở dữ liệu
fetch được lưu vào bộ nhớ đệm qua next, nhưng yêu cầu tới Postgres qua ORM thì không. Có unstable_cache cho nó:
// 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"] }
);Hạn chế: bạn không thể gọi cookies() và headers() bên trong một hàm - chuyển mọi thứ phụ thuộc vào yêu cầu làm đối số. Kết quả phải được tuần tự hóa thành JSON, vì vậy các đối tượng Date sẽ được trả về dưới dạng chuỗi. Tiền tố unstable_ có nghĩa là API có thể thay đổi. Trong Next.js 16, mô hình bộ nhớ đệm lại thay đổi (lệnh use cache và thay đổi thành revalidateTag), vì vậy hãy kiểm tra tài liệu dành cho phiên bản của bạn khi nâng cấp.
Làm thế nào để hiểu những gì được lưu trữ trong bộ nhớ đệm
- 1.Kích hoạt tính năng ghi nhật ký truy vấn trong
next.config.ts:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;Bảng điều khiển máy chủ sẽ hiển thị các dòng cho biết lần truy cập hoặc bỏ sót bộ nhớ đệm cho mỗi fetch.
- 2.Đối với
next starttự lưu trữ, hãy xem tiêu đề phản hồix-nextjs-cache:HIT,STALEhoặcMISScho các trang từ bộ đệm.
- 3.Kiểm tra bản dựng
next build && next start, không phải trongnext dev: ở chế độ phát triển, bộ nhớ đệm hoạt động khác.
##Những lỗi thường gặp
- Mong đợi
revalidateTagcập nhật dữ liệu nhận được mà không cần thẻ. Thẻ bị ràng buộc tại thời điểm yêu cầu. - Không hợp lệ từ thành phần máy khách. Các chức năng từ
next/cachechỉ hoạt động trên máy chủ. - Một số trường hợp
next startđằng sau bộ cân bằng. Bộ nhớ đệm mặc định nằm trong hệ thống tệp của từng phiên bản vàrevalidateTagtrên một phiên bản sẽ không ảnh hưởng đến các phiên bản khác. Bạn cần mộtcacheHandlerchung (ví dụ: trên Redis). - Lưu trữ dữ liệu cá nhân dưới một khóa chung. Nếu câu trả lời phụ thuộc vào người dùng thì ID người dùng phải là một phần của khóa và tốt hơn hết là bạn không nên lưu trữ những dữ liệu đó vào bộ nhớ đệm.
Khi không cần bộ đệm
Việc để bảng quản trị, tài khoản cá nhân và các trang có dữ liệu thời gian thực hoàn toàn động sẽ dễ dàng hơn. Bộ nhớ đệm hợp lý khi cùng một dữ liệu được nhiều người dùng đọc thường xuyên hơn là dữ liệu được thay đổi.