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

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

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

Đ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:

  • fetch không được lưu vào bộ nhớ đệm trừ khi bạn chỉ định rõ ràng cache: 'force-cache' hoặc next.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. 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.

  1. 2.Đối với next start tự lưu trữ, hãy xem tiêu đề phản hồi x-nextjs-cache: HIT, STALE hoặc MISS cho các trang từ bộ đệm.
  1. 3.Kiểm tra bản dựng next build && next start, không phải trong next dev: ở chế độ phát triển, bộ nhớ đệm hoạt động khác.

##Những lỗi thường gặp

  • Mong đợi revalidateTag cậ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/cache chỉ 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à revalidateTag trê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ột cacheHandler chung (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.

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

Ещё на vbcd4u.com