数据获取(App Router)
优先级:P0(关键)
[!WARNING] 此技能涵盖 App Router 的数据获取(
fetch)。如果项目使用pages/目录,则必须改用getServerSideProps或getStaticProps。请忽略此文件中关于原生fetch缓存的建议。
在服务器组件中直接使用 async/await 获取数据。
策略
- 静态:构建时。
fetch(url, { cache: 'force-cache' }) - 动态:请求时。
fetch(url, { cache: 'no-store' })或cookies() - 带重新验证:
fetch(url, { next: { revalidate: 60 } })
模式
- 直接访问:直接调用数据库/服务层。不要获取你自己的 /api 路由。 示例:
export default async function Page() { const user = await db.user.findUnique({ where: { id }, select: { id: true, name: true } }); } - 就近存放:在需要数据的地方精确获取。
- 并行:使用
Promise.all()防止瀑布请求。 - 客户端:对实时/用户特定数据(无 SEO 需求)使用 SWR 或 React Query。
重新验证
- 路径:
revalidatePath('/path')- 清除路由的缓存。 - 标签:
revalidateTag('key')- 按标签清除缓存。
反模式
- 不要使用根级别的 await:将慢速获取包裹在
<Suspense>中以避免阻塞。 - 不要使用
useEffect获取数据:在客户端使用 SWR 或 React Query。 - 不要从 RSC 内部调用 API:直接从数据库/服务层获取。