本文档旨在指导开发者如何在 Next.js 13 的 App Directory 中实现按需重新验证（On-Demand Revalidation）。通过 `revalidateTag` 和 `revalidatePath`，开发者可以精确控制页面缓存的更新时机，无需定期重建整个站点，从而优化性能和用户体验。我们将通过示例代码演示如何使用这些功能，并提供注意事项，帮助你更好地理解和应用按需重新验证。
Next.js 13 App Directory 中的按需重新验证
在 Next.js 13 的 App Directory 中，按需重新验证（On-Demand Revalidation）允许开发者根据特定事件（例如，Webhook 触发）来更新缓存的页面，而不是依赖于固定的时间间隔。这提供了更细粒度的控制，避免了不必要的重建，提高了应用程序的性能。Next.js 提供了 revalidateTag 和 revalidatePath 两个函数来实现这一功能。
使用 revalidateTag
revalidateTag 允许你根据标签（Tag）来重新验证缓存。首先，在获取数据时，为请求添加一个标签：
export default async function Page() {
const user = await fetch("/api/user", { next: { tags: ["user"] } })
const userData = await user.json();
return 我是 {userData.name}, 我的页面很漂亮
}在这个例子中，我们使用 tags: ["user"] 为 /api/user 请求添加了一个名为 user 的标签。
然后，在需要触发重新验证的地方（例如，在处理表单提交或接收到 Webhook 时），使用 revalidateTag 函数：
import { revalidateTag } from 'next/cache'
export default async function FormPage() {
const addUser = async (formData) => {
"use server";
const name = formData.get('name');
await fetch("/api/user/update", {
method: 'POST',
body: JSON.stringify({name})
});
revalidateTag("user") // 触发重新验证
};
return(
<>
在这个例子中，当表单提交并成功更新用户信息后，revalidateTag("user") 会触发所有带有 user 标签的缓存重新验证。注意，addUser 函数需要标记为 "use server"，才能在服务器端运行。
使用 revalidatePath
revalidatePath 允许你根据路径来重新验证缓存。 这在需要重新验证整个路径下的所有页面时非常有用。
import { revalidatePath } from 'next/cache'
async function updateData() {
// ... 更新数据的逻辑
revalidatePath('/blog') // 重新验证 /blog 路径下的所有页面
}在这个例子中，revalidatePath('/blog') 会触发 /blog 路径下的所有缓存页面重新验证。
注意事项
- "use server" 指令: 在服务器组件中使用 revalidateTag 或 revalidatePath 时，必须确保函数使用了 "use server" 指令。
- 错误处理: 在实际应用中，应该添加适当的错误处理机制，以确保重新验证操作在出现问题时不会导致应用程序崩溃。
- 缓存策略: 了解 Next.js 的缓存策略对于正确使用按需重新验证至关重要。 默认情况下，Next.js 会缓存路由和数据。
- API 路由: 使用 revalidateTag 和 revalidatePath 的 API 路由需要部署为 Edge Functions 或 Node.js 函数，以便在服务器端执行。
总结
按需重新验证是 Next.js 13 App Directory 中一个强大的功能，它允许开发者更精确地控制页面缓存的更新，从而优化应用程序的性能和用户体验。通过 revalidateTag 和 revalidatePath，开发者可以根据特定事件触发缓存更新，避免不必要的重建。正确理解和使用这些功能，可以构建更高效、更灵活的 Next.js 应用程序。
