跳到正文

博客

我们为什么把 Ofrai 架在 Next.js App Router 上

作者:Ofrai Editorial(Editorial Team)

Ofrai 跑在 Next.js 16 App Router 上,六个语言、按语言分片的 sitemap、每个长内容页都有 JSON-LD。这篇文章讲我们怎么落到这个架构,框架白送了哪些能力,以及为了把多租户 SEO 调到 Google 期望的样子,我们又在框架外面搭了什么。

为什么选 App Router

三个我们不后悔的理由。第一,流式渲染:模型页头部和面包屑先即时出来,目录加载器在服务端继续跑。我们把 /models 的首字节时间从 600 毫秒降到中位数 200 毫秒以下。第二,嵌套布局:营销壳在 app/[locale]/layout.tsx,工作台壳在 app/[locale]/[studio]/layout.tsx,模型页在 app/[locale]/models/[slug]/page.tsx。

兄弟节点之间跳转不会重新渲染 —— 工作台布局缓存住,页面槽位填充。第三,默认服务端组件:长内容页里唯一的客户端代码是语言切换、分享按钮和 Cookie 横幅。水合开销大头在 next-intl,不在我们。next-intl 通过服务端的 getRequestConfig 和客户端的 NextIntlClientProvider 与 App Router 集成,这次迁移花了一周而不是一个月。

不靠子域的 i18n

我们没有跑 ofrai.com、ofrai.cn、ofrai.de。六个语言全在同一个源站底下,走路径前缀 —— /en、/zh、/ja、/ko、/de、/fr。三个原因:一张 TLS 证书、一个 cookie 作用域、一套 CDN 规则。代价是 URL 带上语言前缀;收益是不用跨六个域协调 HSTS、CSP 和 robots。next-intl 从 URL 前缀读语言,再调 setRequestLocale,让页面里的 getTranslations 解析到对应的 messages/<locale>.json。

我们在 app/[locale]/layout.tsx 里吐 hreflang 集群标签 —— 每个语言一条 <link rel='alternate' hreflang='x' href='<site>/<x>/<path>' />,再加一条 x-default 指到 /en。sitemap 是分片的:sitemap.xml 是索引,每个分区(marketing、models、compare、use-cases、tools、features、guides、scenes)一个 <sitemap> 文件,里面每条路径按语言展开。八分区乘六语言是我们今天发布的上限。

SEO 上白捡的能力

老实说,不少。JSON-LD —— SeoArticle 组件在每个长内容页吐 Article、BreadcrumbList 和 FAQPage 三种 JSON-LD,外加署名对应的 Person 块;这是一个组件,而不是每个页面各自决定。规范链接 —— app/[locale]/blog/[slug]/page.tsx 调 buildPageMetadata 传绝对路径,框架接管剩下的;我们从不手写 canonical <link>。OG 动态图 —— app/api/og/route.tsx 用 Next 的 ImageResponse 渲染 1200x630 动态 OG 卡,没有第三方服务参与。

Sitemap 分片 —— 八份 sitemap 文件,一份索引,爬取预算不是我们要打的仗。带 revalidate 的静态渲染 —— 大多数长内容页 export revalidate = 3600,构建时预渲染,每小时刷新;Googlebot 每次抓取都看到新的时间戳,零请求路径开销。最大的一笔白送是这一切都不需要 CMS。长内容文案住在 content/seo/*.ts 的 TypeScript 模块里,App Router 渲染它们,sitemap 读取它们。

没有数据库,没有管理后台,没有预览服务器。

我们不得不自己补的

框架没按我们想要的方式解决缓存。Next 对静态路由默认 force-cache,对动态路由默认 no-store;我们要的是中间档 —— 按路由的 stale-while-revalidate 加一条手动失效通道。我们写了一个小辅助:包住路由处理器,先查 Redis 的 tombstone key,再退回到静态缓存。

ISR 的 revalidate 导出是按路由且全局的;我们的辅助是按路由且按 key 的,两套并存。CDN 缓存头是下一个意外 —— Vercel 边缘缓存把 revalidate = 3600 当成新鲜度的硬上限,但我们想在内容改完十五分钟内看见,于是编辑管线里加了一次手动的 revalidatePath(),把 Next 缓存和 CDN 边缘一起清掉。这个部署钩子跟着 main 每次合并跑,不暴露给用户。

第三方是中间件 —— App Router 中间件跑在 Edge 运行时上,没有 Node API 可用,所以我们把中间件压在语言识别和跳转,把剩下的全部推到路由处理器里,省掉一个独立的 Edge 兼容 auth 模块。

如果重来一遍会改的

三件事,按后悔程度排序。RSC 边界 —— 我们有过页面里一个小客户端岛把整个服务端子树拽进了客户端 bundle;现在我们守一条规则:任何要用 useState 或 useEffect 的东西是一个独立的客户端组件,并以叶子方式引入,因为框架不会替你拦错的选择。

水合体积 —— next-intl 的客户端 provider 会把当前语言的全部消息命名空间打包进客户端,我们改成在页面里懒加载真正用到的命名空间;/pricing 上省了大约 90 kB JS。中间件限制 —— Edge 运行时快但用不了 Stripe SDK 和 Drizzle;如果重来一遍,中间件只放跳转,绝不让它碰 auth。老实说结论是:App Router 免费送了我们要的 80%。

剩下的 20% 是每个框架都要交的集成税 —— 缓存、CDN,以及那些跑在框架之前的栈。

常见问题

Next.js 适合做 SEO 吗?
适合。App Router 提供流式 SSR、通过 generateMetadata 自动出规范链接、服务端组件保持客户端 JS 小、并自带 ImageResponse 动态 OG 图。在 Ofrai 我们博客、对比页和模型页都靠这四项,没有任何第三方 SEO 服务参与。
Next.js App Router 和 Pages Router,做 SEO 哪个更好?
今天做 SEO 选 App Router 是更好的默认。流式渲染让头部和面包屑先出来,服务端组件压低水合体积,框架接管 canonical 和元数据,页面里犯错的概率更小。Pages Router 还能用,但要放弃流式渲染,并且每页样板代码更多。
Next.js 怎么做 hreflang?
在 App Router 里,每个语言渲染一条 <link rel='alternate' hreflang='<locale>' href='<site>/<locale>/<path>' />,再加一条 x-default 指到默认语言,可以放在根布局或路由段的 generateMetadata 里。我们同时为每个语言出一份 sitemap,让每个 hreflang 目标在索引里都有一条匹配。
Next.js 多租户或多语言 SEO 怎么做?
路径前缀语言(不用子域)、一套 canonical/hreflang、每个语言一份 sitemap、外加 ISR 加手动失效通道。Ofrai 六个语言都这么发,Google 索引全六套,无需我们跨多个源站协调 TLS 或 HSTS。
Next.js App Router 能不能配 next-intl?
可以。next-intl 在 getRequestConfig 里从 URL 前缀读语言,对服务端组件暴露 getTranslations 和 setRequestLocale,对客户端组件暴露 NextIntlClientProvider。我们一周完成迁移,每页客户端 JS 只打包真正用到的翻译命名空间。

相关文章