/rules/async-api-routes.md

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

## 防止 API 路由中的瀑布链

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

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

```typescript
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 立即启动）：**

```typescript
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` 来自动最大化并行度（参见「基于依赖的并行化」）。