React / 系统课时
刷新变更结果
刷新变更结果
服务端操作成功并不等于用户立刻看见新数据:旧缓存、当前路由内容和后续跳转是三个不同问题。本篇把 revalidatePath、refresh 与 redirect 分开使用,让一次写入之后的界面状态可预测。
学习目标
- 区分缓存失效、当前路由刷新和成功后跳转
- 在 Server Action 中按正确顺序刷新受影响的数据
- 避免把
refresh()当作缓存失效 API,或在跳转后执行无效代码
先区分三种更新
| API | 解决的问题 | 典型用法 |
|---|---|---|
revalidatePath() |
让指定页面或布局的缓存数据失效 | 列表或详情数据被写入后重新获取 |
refresh() |
从 Server Action 刷新当前客户端路由 | 当前页还有需要重新读取的未缓存数据 |
redirect() |
成功后导航到另一个地址 | 创建完成回列表、编辑完成进详情页 |
refresh() 不会替代缓存失效;如果页面读的是缓存数据,仍要使用 revalidatePath(),或按数据标签选择相应的标签更新 API。若操作完成后马上离开当前页,则通常不必先 refresh()。

把写入、缓存和导航排成一条链
下面是片段示例,依赖 @/app/lib/posts 中的 updatePost 已完成真实持久化。两个 Action 展示“保存后跳走”和“保存后留在当前页”两种常见结果。
ts
// app/actions/posts.ts
'use server';
import { refresh, revalidatePath } from 'next/cache';
import { redirect } from 'next/navigation';
import { updatePost } from '@/app/lib/posts';
export async function saveAndOpenList(
postId: string,
formData: FormData,
) {
const title = String(formData.get('title') ?? '').trim();
await updatePost(postId, { title });
// 先让会展示旧文章数据的路径失效,再执行导航。
revalidatePath('/posts');
revalidatePath(`/posts/${postId}`);
redirect('/posts');
}
export async function saveAndStay(
postId: string,
formData: FormData,
) {
const title = String(formData.get('title') ?? '').trim();
await updatePost(postId, { title });
// 缓存数据仍由 revalidatePath 负责;refresh 只刷新当前客户端路由。
revalidatePath(`/posts/${postId}`);
refresh();
}预期结果:调用 saveAndOpenList 后,文章列表与当前文章详情的缓存都会失效,用户随后进入 /posts 并看到最新标题;调用 saveAndStay 时,用户留在当前详情页,缓存数据被重新验证,同时当前客户端路由重新获取需要更新的内容。
为什么顺序不能颠倒
redirect() 会终止当前 Server Action 的正常控制流,因此它应该放在数据库写入和缓存失效之后。若先跳转,再写 revalidatePath(),后面的代码不会执行,目标页面就可能继续读取旧缓存。
同理,不要把 redirect() 包进会吞掉异常的普通 try/catch。它通过特殊控制流完成跳转;如果必须捕获数据库异常,应只包住数据库操作,把 revalidatePath() 和 redirect() 放在成功路径上。
最终要判断的是“哪些数据变了、用户接下来留在哪里”。先让变更涉及的缓存失效,再根据交互选择留在当前页刷新,或直接跳到目标路由,界面就不会出现“保存成功但仍显示旧值”的错觉。
按自己的节奏,确认真正理解。