SuperAPI AI 工具集

react-server-components-framework

前端与建站

查看项目

更新于 10-15 15:32

技能介绍

用途

该技能用于在构建 Next.js 16+ 应用时提供 React Server Components(RSC)相关的实践指导,覆盖 App Router 模式、Server Components、Server Actions 与流式渲染。适用于以下场景:

  • 使用 App Router 构建 Next.js 16+ 应用
  • 设计组件边界(Server Component 与 Client Component)
  • 实现带缓存与再验证的数据获取
  • 使用 Server Actions 创建变更操作
  • 通过流式渲染与 Suspense 优化性能

主要能力

Server 与 Client 组件区分

资料给出对照表:Server Component 无指令(默认)、支持 async/await、不支持 Hooks 与浏览器 API、可访问数据库、不向客户端发送 JS;Client Component 使用 'use client' 指令、不支持 async/await、支持 Hooks 与浏览器 API、不可访问数据库、会向客户端发送 JS。关键规则:Server Component 可以渲染 Client Component,但 Client Component 不能直接导入 Server Component(应改用 children prop)。

数据获取与缓存

Next.js 16 推荐使用 Cache Components,通过 'use cache' 指令配合 cacheLife、cacheTag 使用,包含默认(跨用户共享)、remote(16.2+,始终由边缘/CDN 提供)、private(16.2+,按用户会话缓存)三种变体。缓存失效使用 revalidateTag,v16 要求第二个参数为 cacheLife profile,也可使用 updateTag 实现 read-your-writes。需在 next.config.ts 中启用 cacheComponents: true(16.2+,替代 experimental_ppr 标志)。资料同时列出 Next.js 15 的旧版 fetch 选项(force-cache、revalidate、no-store、tags)。

Server Actions

使用 'use server' 指令定义异步函数,可读取 FormData、写入数据库,并配合 revalidatePath 与 redirect 使用。

异步 params/searchParams(Next.js 16)

路由参数与搜索参数现为 Promise,必须 await。该变更同样适用于 layout.tsx、generateMetadata() 与 route handlers。

开发服务器(Next.js 16.2 LTS)

Turbopack 为默认打包器,next dev 与 next build 无需 --turbo 标志;仅在被迫使用旧插件时传 --webpack。Server Fast Refresh 默认开启,Server Components 保存后热重载且不丢失客户端状态。Next DevTools MCP 可通过在 .mcp.json 中注册 npx -y next-devtools-mcp@latest 使用,它通过开发服务器的 /_next/mcp 端点连接,向 MCP 客户端暴露 RSC payload 与缓存边界,供 AI 代理在会话中检查渲染树。资料注明不存在 next-browser 二进制。

参考资料与模板

可按需通过 Read("references/<file>") 加载:ork-delta.md(内部规则与修正)、tanstack-router-patterns.md(不依赖 Next.js 的 React 19 特性)、capability-details.md(12 项 RSC 能力的关键词与问题映射元数据)。模板脚本包括 server-component-template.tsx、client-component-template.tsx、server-action-template.ts、create-server-component.md。

使用方式

资料以技能文档形式组织,包含快速参考、代码示例、最佳实践与故障排查表。上游主题(Server Components 基础、Client Components 与 hydration、边界与组合模式、数据获取与缓存、流式 SSR、Server Actions、高级路由、Pages Router 迁移、Next.js 16 升级、Cache Components、React 19 核心 API、RSC 实现与部署清单)由第一方技能与文档覆盖,本技能仅保留底线、经验与内部决策。

适用场景

适合正在使用或迁移到 Next.js 16+ App Router 的前端/全栈开发者,尤其是需要处理组件边界、缓存策略、流式渲染与 Server Actions 的团队。

限制

资料未提供该技能的收费、价格、平台支持范围或效果数据,这些信息暂未提供。部分内容(如 Next.js 16.2.6 / React 19.2.6 安全版本、2026 年时间点)以资料原文为准,未作额外验证。