revalidatePath 和 revalidateTag 什么时候该用

缓存失效策略 这件事在 2023 年开始越来越频繁地进入真实项目，但很多团队一开始只看到表面收益，没有先把边界收住。只要 改了一条数据后不知道该刷新哪个层级，最后只能一股脑全刷，问题就会很快从“一个小体验瑕疵”变成系统性的维护成本。

我现在更倾向的做法，是先把这类能力当成正式工程问题来看，而不是把它当成一个临时技巧。对我来说，最关键的一步通常是 路径级刷新适合页面级依赖，标签级刷新适合共享数据依赖，因为只有边界先明确，后面的优化、扩展和排查才不会一直漂。

真正容易被忽略的，往往不是功能能不能做出来，而是以下这些细节：

• 先画清楚数据被哪些页面复用，再决定失效粒度
• 缓存策略别只图快，排查一致性时可解释性更重要
• 失效调用要集中在 mutation 入口，别四处散落

这些细节看起来都不大，但它们决定了系统是在 demo 阶段“能跑”，还是进入业务以后依然稳定。越是和 AI、工作流、构建链路这类复杂能力相关，越不能靠感觉把事情糊过去。

前端里的很多“体验问题”本质上都是边界问题

围绕「revalidatePath 和 revalidateTag 什么时候该用」这类前端话题，最常见的误区是先去追求框架技巧，再去补组件边界和状态来源。可一旦项目规模上来，真正让代码变脆的，往往不是少用了某个 API，而是数据获取、缓存失效、交互 pending、组件拆分和构建产物之间没有形成清楚约定。框架升级只会把这些隐性问题更快地暴露出来。

我会先做的落地检查

• 先明确状态由谁拥有、什么时候重置、什么时候延迟更新，避免组件自己偷偷维护第二份真相。
• 把路由、缓存、构建配置和产物入口拆成可独立验证的边界，不要把所有约定都留在默认行为里。
• 一旦某个点已经影响到交互一致性、渲染成本或团队协作效率，就应该把它写成约束，而不是继续靠经验口口相传。

小结

缓存刷新不是“刷新就好”，而是要和数据边界配套。revalidate 选得准，用户看到的状态才更一致。