skillhub-088-vercel-react-best-practices/rules/async-api-routes.md

title, impact, impactDescription, tags

title	impact	impactDescription	tags
防止 API 路由中的瀑布链	CRITICAL	2–10 倍性能提升	api-routes, server-actions, waterfalls, parallelization

防止 API 路由中的瀑布链

在 API 路由和 Server Actions 中，应立即启动独立的操作，即使你还不需要 await 它们。

错误写法（config 等待 auth，data 同时等待两者）：

export async function GET(request: Request) {
  const session = await auth()
  const config = await fetchConfig()
  const data = await fetchData(session.user.id)
  return Response.json({ data, config })
}

正确写法（auth 和 config 立即启动）：

export async function GET(request: Request) {
  const sessionPromise = auth()
  const configPromise = fetchConfig()
  const session = await sessionPromise
  const [config, data] = await Promise.all([
    configPromise,
    fetchData(session.user.id)
  ])
  return Response.json({ data, config })
}

对于依赖链更复杂的操作，请使用 `better-all` 来自动最大化并行度（参见「基于依赖的并行化」）。