nextjs runtime_error ai_generated true

错误：服务端操作已重定向但页面未重新验证。请在重定向前使用 revalidatePath 或 revalidateTag 以确保数据是最新的。

Error: Server Action redirected but the page was not revalidated. Use revalidatePath or revalidateTag before redirect to ensure fresh data.

ID: nextjs/server-action-redirect-without-revalidate

其他格式: JSON · Markdown 中文 · English
88%修复率
83%置信度
1证据数
2024-08-05首次发现

版本兼容性

版本状态引入弃用备注
Next.js 14.x active — — —
Next.js 15.x active — — —

根因分析

服务端操作在修改数据后调用了 redirect()，但未先调用 revalidatePath() 或 revalidateTag()。Next.js 要求服务端操作在重定向前进行显式缓存重新验证，以防止显示过时数据。

English

A Server Action calls redirect() after mutating data without calling revalidatePath() or revalidateTag() first. Next.js requires explicit cache revalidation before redirects in Server Actions to prevent stale data from being displayed.

generic

官方文档

https://nextjs.org/docs/app/api-reference/functions/server-actions#redirecting

解决方案

  1. 在服务端操作中的 redirect() 之前调用 revalidatePath()。示例：'use server'; import { revalidatePath } from 'next/cache'; import { redirect } from 'next/navigation'; export async function updateData(formData) { // 修改数据 revalidatePath('/dashboard'); redirect('/dashboard'); }
  2. 如果您的 fetch 调用已添加标签，请使用 revalidateTag()。示例：revalidateTag('posts'); redirect('/posts');
  3. 如果不想重定向，请返回成功响应，让客户端在服务端操作完成后使用 router.push() 处理导航。

无效尝试

常见但无效的做法:

  1. 100% 失败

    redirect() throws a NEXT_REDIRECT error that stops execution. Any code after redirect() will never run. revalidation must happen before the redirect call.

  2. 95% 失败

    router.refresh() is a client-side method and cannot be called inside a Server Action. It also does not affect server-side cache invalidation.

  3. 60% 失败

    This prevents caching but does not revalidate the specific path after mutation. The redirect will still work, but Next.js will still warn about missing revalidation, and the behavior is not guaranteed in future versions.