NNext.js 中文网 GitHub

unstable_noStore

legacy

unstable_noStore 函数的 API 参考。

在版本 15 中,我们建议使用 connection 代替 unstable_noStore。

unstable_noStore 可用于声明式地选择退出预渲染,并指示特定组件不应被缓存。

jsx
import { unstable_noStore as noStore } from 'next/cache';

export default async function ServerComponent() {
  noStore();
  const result = await db.query(...);
  ...
}

小知识:

  • unstable_noStore 等同于 fetch 上的 cache: 'no-store'
  • 相比 export const dynamic = 'force-dynamic',更推荐使用 unstable_noStore,因为它更细粒度,可以基于每个组件使用
  • 在 unstable_cache 内部使用 unstable_noStore 不会退出静态生成。相反,它将由缓存配置决定是否缓存结果。

用法#

如果你不想向 fetch 传递额外的选项(如 cache: 'no-store'、next: { revalidate: 0 }),或者在无法使用 fetch 的情况下,你可以使用 noStore() 作为所有这些用例的替代方案。

jsx
import { unstable_noStore as noStore } from 'next/cache';

export default async function ServerComponent() {
  noStore();
  const result = await db.query(...);
  ...
}

版本历史#

版本变更
v15.0.0unstable_noStore 被弃用,改用 connection。
v14.0.0引入 unstable_noStore。
Next.js 中文网