React / 系统课时
在服务端获取数据
在服务端获取数据
本课完成一个服务端文章列表:页面组件直接请求远程 API、检查响应状态并渲染结果。整个请求发生在服务器,不需要额外的客户端状态或首屏加载副作用。
学习目标
- 在异步服务端组件中调用
fetch - 为响应定义类型并检查非成功状态
- 理解服务端获取数据对密钥和客户端包体的影响
服务端组件可以直接等待数据
App Router 中的页面默认是服务端组件,可以声明为 async 并直接等待网络、数据库或文件系统结果。服务端完成数据获取后再生成页面,浏览器不需要先下载组件脚本、执行 useEffect,再发起同一轮首屏请求。
下面示例显式使用 cache: 'no-store',表示每次渲染都向数据源请求最新结果。这样缓存行为清晰,也便于后续课程比较不同策略。
// 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>
)
}预期结果:
访问 /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 真实符合结构。对支付、权限或外部合作方接口,应使用运行时校验库或手写校验函数,拒绝缺失字段和错误类型,而不是直接断言后继续处理。