React / 系统课时

理解服务端组件

理解服务端组件

在 App Router 中,服务端组件决定了哪些渲染与数据读取留在服务器,哪些 JavaScript 真正进入浏览器。本课会把执行位置、传输内容和交互边界串起来,并用一个最小示例说明何时保留服务端组件、何时切到客户端组件。

学习目标

  • 说清服务端组件的执行位置与浏览器实际接收的内容
  • 理解服务端组件在数据访问、客户端体积和安全边界上的价值
  • 能识别必须交给客户端组件处理的交互职责

服务端组件到底运行在哪里

在 Next.js App Router 中,组件默认是服务端组件,不需要额外指令。它的组件函数在服务器环境中执行;根据路由的渲染方式,这次执行可能发生在构建阶段,也可能发生在请求处理阶段,但不会在浏览器里重新执行同一份服务端组件代码。

服务端组件完成渲染后,React 会产生 RSC Payload。它描述服务端组件的渲染结果,以及客户端组件应该插入的位置和对应引用。首次加载时,Next.js 还会利用这些结果生成 HTML,让用户先看到页面;随后浏览器用 RSC Payload 协调组件树,并对客户端组件进行水合。

服务端组件从服务器到浏览器的渲染数据流

为什么默认把更多内容留在服务端

服务端组件适合承担数据读取、权限判断前的服务器逻辑、静态内容组合以及依赖较重但不需要浏览器执行的代码。因为这些模块不进入客户端组件的 JavaScript 图,可以减少需要下载、解析和执行的客户端代码。

它也允许组件直接访问服务器可用的数据源或凭据,不必为了“先取数据再渲染”额外经过浏览器 API。不过这不是自动保密机制:只要你把敏感值渲染进页面,或作为 props 传给客户端组件,它仍可能到达浏览器,因此真正的密钥和内部字段必须停留在服务端。

用一个页面看清职责分工

下面是放入现有 Next.js App Router 项目的完整文件示例。页面本身保留为服务端组件,数据读取也留在服务器;只有需要 useState 和点击事件的按钮进入客户端边界。

tsx
// app/page.tsx
import LikeButton from './like-button';

async function getArticle() {
  // 真实项目可在这里读取数据库或调用仅服务器可访问的服务。
  return { title: 'Server Components', likes: 12 };
}

export default async function Page() {
  const article = await getArticle();

  return (
    <main>
      <h1>{article.title}</h1>
      <p>初始点赞:{article.likes}</p>
      <LikeButton initialLikes={article.likes} />
    </main>
  );
}

// app/like-button.tsx
'use client';

import { useState } from 'react';

export default function LikeButton({ initialLikes }: { initialLikes: number }) {
  const [likes, setLikes] = useState(initialLikes);

  // 交互状态只属于按钮,因此客户端边界不需要扩大到整个页面。
  return <button onClick={() => setLikes(likes + 1)}>点赞 {likes}</button>;
}

预期结果

text
页面显示标题:Server Components
页面显示:初始点赞:12
按钮初始显示:点赞 12;点击一次后变为:点赞 13

这里最关键的不是“一个文件在服务端、一个文件在客户端”,而是职责被切开了:服务器负责拿数据并生成不可交互的主体 UI,浏览器只接管真正需要状态和事件的按钮。

不要把服务端组件等同于传统 SSR

传统 SSR 通常强调“在服务器先生成 HTML,再由同一套组件代码在浏览器水合”。服务端组件的边界更进一步:服务端组件本身的实现代码不会作为客户端组件 JavaScript 发送到浏览器,客户端只接收它的渲染结果和必要引用。

因此,判断组件归属时不要先问“这个页面是否需要 SSR”,而应问“这段逻辑是否需要在浏览器执行”。只要不依赖状态、事件处理、浏览器 API 或客户端专用 Hook,就优先让它留在服务端;真正需要交互的局部,再用客户端组件切出最小边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解服务端组件

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

登录哪都通