在 Next.js 的 Pages Router 中，revalidatePath() 不可用；必须使用 API 路由响应对象提供的 response.revalidate(path) 方法来手动清除指定路径的缓存。
在 next.js 的 pages router 中，`revalidatepath()` 不可用；必须使用 api 路由响应对象提供的 `response.revalidate(path)` 方法来手动清除指定路径的缓存。
当你在 Pages Router（即 pages/ 目录）中构建数据更新逻辑时，常会遇到“编辑后页面仍显示旧内容”的问题——这是因为 Next.js 对 getStaticProps 渲染的页面启用了静态生成（SSG）与增量静态再生（ISR），其缓存不会自动失效。你可能查阅文档后尝试调用 revalidatePath('/resource/[name]')，但随即收到类似 Invariant: static generation store missing in revalidateTag 的报错。这并非代码错误，而是根本性误用：revalidatePath 是 App Router（app/ 目录）专属的客户端/服务端函数，完全不兼容 Pages Router 的 API 路由上下文。
✅ 正确做法是：在 Pages Router 的 API 路由处理器中，直接调用 response.revalidate(path)：
// pages/api/resource.js
export default async function handler(req, res) {
if (req.method !== 'POST') return res.status(405).end();
try {
const id = await saveResource(req.body); // 你的业务逻辑
// ✅ 正确：Pages Router 唯一支持的路径重验证方式
res.revalidate('/resource/[name]');
res.revalidate('/resource/[name]/edit');
res.status(200).json({ id });
} catch (err) {
res.status(500).json({ error: err.message });
}
}⚠️ 注意事项：
- res.revalidate(path) 仅在生产环境生效（开发模式下无缓存，故该调用被忽略）；
- path 必须是完整的、以 / 开头的路径匹配模式，且需与 getStaticPaths 中定义的路径格式一致（例如 /resource/foo 会匹配 /resource/[name]）；
- 每次调用最多可传入一个路径字符串（不支持数组），如需刷新多个路径，请多次调用；
- 确保该 API 路由被实际访问（例如通过 fetch 触发），且目标页面确实使用了 getStaticProps + revalidate 选项（否则重验证无意义）；
- 若页面使用 getServerSideProps，则无需手动重验证——每次请求都会实时生成。
? 小技巧：为提升健壮性，建议将重验证路径封装为配置项，并在更新成功后统一调用：
const REVALIDATE_PATHS = [ '/resource/[name]', '/resource/[name]/edit', '/resource' ]; // … 在保存逻辑之后 REVALIDATE_PATHS.forEach(path => res.revalidate(path));
总结：Pages Router 与 App Router 的缓存控制机制截然不同——不要被跨版本文档误导。牢记口诀：Pages 用 res.revalidate()，App 用 revalidatePath() 或 revalidateTag()。迁移项目时务必核对当前路由模型，这是避免 ISR 缓存失效类问题的关键前提。
