React / 系统课时

在服务端获取数据

在服务端获取数据

本课完成一个服务端文章列表:页面组件直接请求远程 API、检查响应状态并渲染结果。整个请求发生在服务器,不需要额外的客户端状态或首屏加载副作用。

学习目标

  • 在异步服务端组件中调用 fetch
  • 为响应定义类型并检查非成功状态
  • 理解服务端获取数据对密钥和客户端包体的影响

服务端组件可以直接等待数据

App Router 中的页面默认是服务端组件,可以声明为 async 并直接等待网络、数据库或文件系统结果。服务端完成数据获取后再生成页面,浏览器不需要先下载组件脚本、执行 useEffect,再发起同一轮首屏请求。

下面示例显式使用 cache: 'no-store',表示每次渲染都向数据源请求最新结果。这样缓存行为清晰,也便于后续课程比较不同策略。

tsx
// app/posts/page.tsx
type Post = {
  id: string
  title: string
  content: string
}

async function getPosts(): Promise<Post[]> {
  const response = await fetch('https://api.vercel.app/blog', {
    cache: 'no-store',
  })

  if (!response.ok) {
    throw new Error(`获取文章失败:${response.status}`)
  }

  return (await response.json()) as Post[]
}

export default async function PostsPage() {
  const posts = await getPosts()

  return (
    <main>
      <h1>文章列表</h1>
      <ul>
        {posts.map((post) => (
          <li key={post.id}>
            <h2>{post.title}</h2>
            <p>{post.content}</p>
          </li>
        ))}
      </ul>
    </main>
  )
}

预期结果:

text
访问 /posts 后显示“文章列表”,下方渲染远程 API 返回的多篇文章。
文章 ID、标题和内容属于动态数据,实际值可能不同,例如 <ID>、<TITLE> 和 <CONTENT>。

为什么不需要 useEffect

若首屏数据只用于服务端生成页面,把请求放进客户端 useEffect 会产生额外往返:浏览器先看到空壳,再下载 JavaScript、完成水合并请求数据。服务端组件能够省去这段等待,并减少发送到浏览器的业务代码。

客户端获取仍有适用场景,例如持续轮询、用户输入驱动的搜索和不需要服务端渲染的局部面板。判断依据不是“哪种写法更新”,而是数据是否参与首屏输出、是否依赖浏览器状态,以及是否需要持续交互。

安全处理服务端凭据

服务端组件可以读取未暴露给浏览器的环境变量,例如 process.env.INTERNAL_API_TOKEN。不要给敏感变量添加 NEXT_PUBLIC_ 前缀,也不要把完整令牌写入错误信息、页面属性或日志。

从服务端组件获取业务数据时,优先直接调用真正的数据源或共享数据访问函数。不要为了复用接口形式而请求项目自己的 Route Handler,这会增加一次无意义的 HTTP 往返,并让构建与部署地址更复杂。

校验响应与数据形状

fetch 在收到 404 或 500 时通常不会自动抛出异常,因此必须检查 response.ok。网络断开会直接抛错,而响应体格式错误可能在 response.json() 阶段失败,这些情况都应交给当前路由的错误边界处理。

TypeScript 类型只约束编译阶段,不能证明远程 JSON 真实符合结构。对支付、权限或外部合作方接口,应使用运行时校验库或手写校验函数,拒绝缺失字段和错误类型,而不是直接断言后继续处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在服务端获取数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通