Skip to content

约 4 分钟阅读

元框架与全栈框架 ​

元框架建立在 React、Vue、Svelte 等组件框架之上,负责路由、渲染模式、数据加载、构建部署和服务端能力。它们解决的不是“怎么写组件”,而是“一个完整 Web 应用如何组织和交付”。

商品介绍、库存和个人订单虽然在同一个站点,更新规律却不同:介绍可在构建时生成,库存需要请求时读取,订单还需要身份隔离。选型的第一步是按数据与页面划分运行合同,而不是给整个网站贴上唯一的SSR标签。

静态内容、请求时渲染与浏览器交互的运行边界

主流框架 ​

框架基础生态适用场景
Next.jsReact官网、内容站、SSR/SSG、全栈 React 应用
NuxtVueVue 生态下的 SSR/SSG、内容站、业务应用
SvelteKitSvelteSvelte 全栈应用、轻量 SSR/SSG 项目
Astro多框架内容站、文档、博客、营销页、岛屿架构
React Router框架模式React路由模块、loader/action、服务端或静态交付;Remix v2应用可迁移至v7
UmiReact国内中后台、企业级路由和工程规范

渲染模式 ​

模式说明适用场景
CSR浏览器端渲染,服务端只返回静态入口内部后台、登录后应用
SSR请求时在服务端渲染 HTMLSEO、首屏性能、动态内容
SSG构建时生成静态 HTML文档、官网、博客、营销页
ISR / 增量生成静态页面按策略更新内容频繁变化但不需要每次实时渲染
Islands页面大部分静态,局部组件激活内容站和性能敏感页面

选型 ​

React 项目需要 SSR、文件路由、服务端接口和成熟托管生态时,优先看 Next.js。Vue 项目需要类似能力时,优先看 Nuxt。内容站、文档和营销页如果交互较少,应重点评估 Astro,因为它能减少默认发送到浏览器的 JavaScript。

Umi 在国内中后台项目中常见,适合已有 Ant Design、权限、菜单、路由约定和企业工程规范的团队。React Router框架模式沿用Remix的数据加载与提交思路,维护旧Remix项目时应区分版本和迁移合同,不能把两套路由配置混写。

以商品与订单拆分运行合同 ​

公开介绍页可在构建时读取内容并输出HTML,更新内容后重新构建;价格与库存若要求新鲜数据,可在请求时渲染或由浏览器读取API。订单页必须携带访问者身份,服务器查询和缓存键都要隔离用户,不能把某次请求的订单HTML作为全站公共缓存。

SSR输出HTML后,客户端交互组件通常还需要下载脚本并激活。浏览器与服务器初始状态不一致会导致hydration问题,例如服务端使用本地时区格式化日期、客户端使用另一时区,或首屏直接读取localStorage。把环境相关逻辑放到明确边界,不能只用隐藏警告处理差异。

业务对象执行位置更新与失败合同
商品图文介绍构建器生成HTML,CDN提供发布重建;构建数据源不可用时发布失败或沿用已验证版本
库存与实时价格服务器或浏览器请求API明确刷新频率、过期标识、超时和降级
登录后的订单受鉴权的服务器/API按身份授权与缓存隔离,拒绝跨用户读取
数量选择和表单草稿浏览器组件本地交互,提交时服务器重新校验

每个框架对缓存、路由文件和adapter的实现不同,ISR不是所有框架通用的配置项。部署前按实际版本检查“哪些页面预生成、哪些路径要请求运行时、哪些资源需要保留旧版本”。

注意点 ​

元框架会影响部署方式。SSR 应用需要 Node.js 服务、Serverless 或边缘运行环境;SSG 可以直接部署到 Nginx、对象存储或 CDN。选型前要确认团队是否能维护对应运行时,而不是只看开发体验。

现象检查点
本地正常线上失败SSR 运行环境、环境变量、Node.js 版本
SEO 不生效页面是否真实 SSR/SSG,是否被客户端异步渲染覆盖
构建时间过长页面数量、静态生成策略、远程数据请求
缓存混乱HTML、数据接口、CDN 和浏览器缓存层级

验收至少覆盖直接打开深层URL、刷新、登录后换账号、浏览器前进后退、API超时以及旧页面加载新发布资源。可以用curl -s http://localhost:端口/商品路径检查初始HTML是否包含商品正文,但这只验证返回内容,仍需浏览器验证交互和客户端导航。部署页说明静态资源与运行时服务如何共同交付。

别急,先让缓存热一下。