跳到主要内容
api工厂
框架动态

React Router v7 框架模式:loader/action、SSR 与 Remix 的合体之路

api工厂资讯栏目 约 6 分钟阅读 更新于
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:React Router v7 于 2024 年 11 月 22 日发布,最大的变化是把 Remix 的核心能力整体并入——框架模式下你获得 loader/action 数据模型、SSR/预渲染、文件路由与基于 Vite 的编译链,而不再需要单独安装 Remix。对已有 React SPA,v7 可以只当路由库用;对需要 SEO 与首屏速度的项目,框架模式是 React 生态里与 Next.js 并列的全栈选项。Remix 2 项目则有一条官方铺好的平滑迁移路径。

一、三种模式:按需取用

v7 把使用方式分成三档,复杂度递增:

声明模式:BrowserRouter + Routes,经典 SPA 路由,适合存量项目渐进升级;数据模式:createBrowserRouter 把路由配置移到渲染之外,支持 loader/action 与挂起状态,但没有服务端编译;框架模式:完整的 Remix 体验——文件即路由、SSR/SSG、自动代码分割、逐路由类型生成。

bash
npx create-react-router@latest my-app

关键认知:三种模式共享同一套 API 与心智模型,从声明模式迁到框架模式不需要换脑子,这是 v7 相对「另起炉灶学一个新框架」的最大优势。

二、loader:把数据请求挪到渲染之前

传统 React 的「渲染组件 → useEffect 里 fetch → setState」会制造请求瀑布:父组件取完数据子组件才开始取。loader 在路由匹配时就并行执行,组件渲染时数据已就绪:

tsx
// app/routes/user.tsx
import { useLoaderData } from 'react-router';

export async function loader({ params }) {
  const [user, posts] = await Promise.all([
    fetchUser(params.userId),
    fetchPosts(params.userId),
  ]);
  return { user, posts };
}

export default function UserPage() {
  const { user, posts } = useLoaderData<typeof loader>();
  return <h1>{user.name}</h1>;
}

框架模式下 loader 默认跑在服务端,可以直接访问数据库与密钥;需要浏览器 API 时用 clientLoader,还能通过 serverLoader 参数与服务端数据组合。SSR 首屏因此天然带完整数据,搜索引擎与用户看到同一份 HTML。

三、action 与 useFetcher:变更即重验证

action 处理 POST/PUT/DELETE 等数据变更,完成后框架自动重新调用相关 loader——「提交 → 落库 → 界面刷新」是声明式的,不需要手动同步状态:

tsx
export async function action({ request }) {
  const form = await request.formData();
  const user = await createUser({ name: form.get('name') });
  return redirect('/users/' + user.id);
}

不想触发导航的交互(点赞、加购、实时搜索)用 useFetcher:它独立调用 loader/action,自带请求状态与竞态处理,过期请求自动取消。表单用 Form 组件提交,即使 JS 未加载也能走原生提交,渐进增强是内建的。

四、SSR、预渲染与类型安全

框架配置集中在 react-router.config.ts:

ts
import type { Config } from '@react-router/dev/config';
export default {
  ssr: true,
  prerender: ['/', '/about'],
} satisfies Config;

ssr 关掉就是纯客户端 SPA,prerender 列表在构建期生成静态 HTML,三种渲染形态一个配置切换。类型方面,react-router typegen 按路由生成类型,loader 返回值、路由参数、href 都有推断与检查;建议把 typegen 放在 tsc 之前执行,避免冷检出时的虚假报错。开发用 react-router dev(带路由模块热重载),构建用 react-router build,产物分 build/client 与 build/server 两部分。

五、从 Remix 2 迁移:包映射表

旧包新包
@remix-run/reactreact-router(v7 统一导出)
@remix-run/node@react-router/node
@remix-run/dev@react-router/dev
@remix-run/serve@react-router/serve
@vercel/remix@vercel/react-router

路由文件想保留 Remix v2 扁平命名,用 @react-router/fs-routes 的 flatRoutes() 一行搞定,URL 可以逐字节不变——这对 SEO 与外链至关重要。json() 助手移除,改返回原生对象或 Response.json;类型导入统一来自 react-router。社区已有文档站级项目的完整迁移案例,核心经验是:把「URL 全部 200、依赖树无 @remix-run 残留、SSR 首屏不回退」写成可执行验收清单,迁移就是一次机械替换。

六、loader 里的数据从哪来:可以不用自建后端

框架模式把「服务端取数」变成一等公民,但取数的后端不一定要自己写。做商城、会员、内容类应用时,可以直接在 loader 里调「api工厂」的开放接口:商品列表、订单、优惠券、CMS 文章都是现成能力,Web 端用 apifm-webapi SDK 封装,统一返回 {code,data,msg},code 为 0 即成功;loader 返回的数据自动注水到客户端,useLoaderData 直接消费,与上面的类型推断链路完全兼容。平台自带管理后台,运营改商品、发文章不需要开发者介入。

接口可先在 https://www.it120.cc/playground.html 在线调通再写进 loader;SDK 用法与六端支持见 https://www.it120.cc/sdk/index.html 。对独立开发者,这等于把 React Router 的全栈能力与现成业务后端拼成完整闭环。

文章标签

React RouterRemixSSRReact

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。