在 Next.js 的 Pages Router 中，无法直接调用 revalidatePath() 函数刷新静态缓存；必须使用 API 路由响应对象提供的 response.revalidate(path) 方法，否则会因上下文缺失而抛出 static generation store missing 错误。
在 next.js 的 pages router 中，无法直接调用 `revalidatepath()` 函数刷新静态缓存；必须使用 api 路由响应对象提供的 `response.revalidate(path)` 方法，否则会因上下文缺失而抛出 `static generation store missing` 错误。
Next.js 提供了两种主要的路由系统：Pages Router（基于 pages/ 目录）和 App Router（基于 app/ 目录）。二者在数据缓存与按需重新验证（on-demand revalidation）机制上存在关键差异——revalidatePath 是 App Router 专属的客户端/服务端函数，不可在 Pages Router 的 API 路由中直接使用。
当你在 Pages Router 的 pages/api/resource.js 中调用 revalidatePath('/resource/[name]') 时，Next.js 内部会尝试通过 fetch.__nextGetStaticStore() 获取当前静态生成上下文，但该上下文仅在 App Router 的服务端组件或 Server Actions 中自动注入。API 路由属于独立的 Node.js HTTP 处理器，不参与 App Router 的异步存储生命周期，因此 staticGenerationAsyncStorage 为 undefined，最终触发 revalidateTag 的 invariant 报错。
✅ 正确做法是：在 Pages Router 的 API 路由中，调用 response.revalidate(path) —— 这是 Next.js 专为 Pages Router 设计的内置响应方法，它会向 Incremental Static Regeneration（ISR）缓存系统发送失效指令：
// pages/api/resource.js
export default async function handler(req, res) {
if (req.method !== 'POST') return res.status(405).end();
try {
const id = await saveStuff(req); // 假设此函数完成资源更新
// ✅ 正确：对 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 必须是已启用 ISR 的页面路径（即对应 pages/resource/[name].js 或 pages/resource/[name]/edit.js，且导出 getStaticProps 并配置了 revalidate 选项），否则调用无效；
- 路径需为绝对路径（以 / 开头），且不包含动态参数的实际值，应保留 [name] 这样的占位符形式（Next.js 会自动匹配所有对应静态生成的版本）；
- 该方法仅在生产环境（next start）下生效；开发模式（next dev）中不触发 ISR，调用会被忽略；
- 每次调用 res.revalidate() 仅针对单个路径，如需失效多个路径，请分别调用；
- 若页面未启用 ISR（即未导出 getStaticProps 或 revalidate 为 false/未设置），则缓存不会被清除，前端仍可能看到旧内容——此时应考虑改用 getServerSideProps 或客户端 SWR/Vercel Edge Caching 等替代方案。
? 补充提示：如果你正在迁移项目或新建应用，建议优先采用 App Router，并使用 revalidatePath 或 revalidateTag 配合 generateStaticParams 实现更灵活的缓存控制；但对于存量 Pages Router 项目，res.revalidate() 是唯一可靠、官方支持的按路径失效方案。
