phase 5 part 1: typescript, vue, react, ssr(Next.js 16) topics with lessons, scenarios, interviews, verified examples

This commit is contained in:
Shikui Wang committed 2026-10-23 16:24:06 +08:00
1 parent 7a32d2c9a6
commit 7b5cae7d24
39 files changed
+2482 -48

No files matched your search

+81
View File
@@ -0,0 +1,81 @@
---
id: frontend.ssr.rendering-modes
title: 渲染模式:CSR / SSR / SSG / ISR、水合、流式渲染和 Nuxt 基础
type: lesson
domain: frontend
stack: [ssr]
tags: [CSR, SSR, SSG, ISR, 水合, Hydration, 流式渲染, Nuxt, SEO]
level: intermediate
prerequisites: [frontend.vue.reactivity-composition]
est_hours: 2.5
related: [frontend.ssr.nextjs-app-router, frontend.fe-testing-perf.index, frontend.ssr.interview]
week: [7]
order: 1
---
# 渲染模式:CSR / SSR / SSG / ISR、水合、流式渲染和 Nuxt 基础
## 解释说明
| 模式 | 在哪里生成 HTML | 优点 | 缺点 | 适合 |
| --- | --- | --- | --- | --- |
| CSR(客户端渲染) | 浏览器执行 JS 后生成 | 服务器简单,交互流畅 | 首屏慢、SEO 差 | 后台系统、登录后的应用 |
| SSR(服务端渲染) | 每次请求时服务器生成 | 首屏快、SEO 好、数据实时 | 服务器压力、需要 Node 服务 | 内容和数据经常变化的公开页面 |
| SSG(静态生成) | 构建时生成 | 最快、可放 CDN | 数据更新要重新构建 | 文档、官网、博客 |
| ISR(增量静态再生成) | 构建时生成 + 过期后后台重新生成 | 兼顾速度和更新 | 有短暂的旧数据 | 商品页、文章页 |
**水合(Hydration)**:服务端返回 HTML 后,浏览器加载 JS,把事件监听和状态“接”到已有的 DOM 上,页面才可以交互。问题:
- 水合不匹配:服务端和客户端渲染结果不一致(用了 `Date.now()`、`Math.random()`、`window`、本地时区),会报警告甚至重新渲染。
- 首屏能看到但点不动(JS 还没加载完):通过减少客户端 JS、部分水合 / 服务端组件、懒加载缓解。
**流式渲染**:服务器先发送页面框架,慢的数据块准备好后再流式补上(React 的 Suspense、Next.js 的 `loading.tsx`),首字节更快。
**Nuxt**(Vue 的全栈框架,当前大版本 Nuxt 4,以官方文档为准:https://nuxt.com/docs):基于文件的路由、`useFetch` / `useAsyncData` 在服务端取数并把结果传给客户端避免重复请求、`server/` 目录写接口(Nitro 引擎)、按路由配置渲染模式(`routeRules`:SSR、预渲染、ISR 类缓存)。
## 案例
电商的帮助中心:常见问题页需要 SEO 和最快的首屏,用 SSG / ISR;智能客服对话需要登录和实时交互,是客户端组件;订单页登录后才能看,用 CSR 或 SSR 都可以,但要注意不能把用户数据缓存到 CDN。
## 代码示例
避免水合不匹配:只在客户端执行的逻辑放到挂载之后。
```vue
<script setup lang="ts">
import { onMounted, ref } from "vue";
const now = ref<string | null>(null); // 服务端渲染时为 null,两端一致
onMounted(() => {
now.value = new Date().toLocaleString("zh-CN"); // 只在浏览器执行
});
</script>
<template>
<span>{{ now ?? "加载中" }}</span>
</template>
```
Nuxt 中服务端取数(结果会序列化到页面中,客户端水合时不会再请求一次):
```vue
<script setup lang="ts">
const { data: faqs, error } = await useFetch("/api/faqs");
</script>
```
Next.js 的写法见下一课和 [examples/next-ai-chat](examples/next-ai-chat/)。
## 易错点
- 在服务端渲染阶段访问 `window`、`localStorage`。
- 服务端渲染时使用了全局单例状态(Pinia、模块级变量),导致不同用户的数据串在一起:每个请求要创建新的实例。
- 把带用户信息的 SSR 页面缓存到 CDN。
- SSR 页面里调用很慢的接口,拖慢整个首屏:并行取数、流式渲染、超时降级。
- 以为用了 SSR 就一定更快:服务器离用户远、取数慢时,TTFB 反而变差。
## 面试常问
- CSR、SSR、SSG、ISR 的区别和适用场景?
- 什么是水合?水合不匹配的原因?
- SSR 项目有哪些常见的坑?
+114
View File
@@ -0,0 +1,114 @@
---
id: frontend.ssr.nextjs-app-router
title: Next.js App Router:服务端组件、客户端组件、路由处理器做 AI 流式接口、缓存
type: lesson
domain: frontend
stack: [ssr, react]
tags: [Next.js, App Router, Server Components, use client, Route Handlers, Server Actions, 流式响应, Turbopack]
level: intermediate
prerequisites: [frontend.react.hooks-rendering, frontend.ssr.rendering-modes]
est_hours: 3
related: [frontend.ssr.scenario.help-center, backend.nodejs.index, frontend.ssr.interview]
week: [7]
order: 2
---
# Next.js App Router:服务端组件、客户端组件、路由处理器做 AI 流式接口、缓存
> 基于 Next.js 16 编写并实际构建通过。Next.js 大版本之间变化很多(例如 16 版默认使用 Turbopack 构建,`middleware` 文件约定改名为 `proxy`,缓存机制也在调整),以官方文档为准:https://nextjs.org/docs 。BOSS直聘 2026-10-23 的调研中有岗位提到 Next.js,它也是“前端出身做全栈”最常见的选择。
## 解释说明
### App Router 的核心概念
| 概念 | 说明 |
| --- | --- |
| 文件路由 | `app/` 目录:`page.tsx` 页面、`layout.tsx` 布局、`loading.tsx` 加载态、`error.tsx` 错误边界、`route.ts` 接口 |
| **服务端组件**(默认) | 在服务器上运行,可以直接访问数据库 / 密钥,代码不会发到浏览器;不能用 `useState`、事件处理 |
| **客户端组件** | 文件顶部写 `"use client"`,可以有状态和交互;它和它导入的模块会打包到浏览器 |
| 路由处理器 | `app/api/xxx/route.ts` 导出 `GET` / `POST` 等函数,使用 Web 标准的 `Request` / `Response`,可以返回流 |
| Server Actions | `"use server"` 的异步函数,可以直接作为表单的 `action`,在服务端执行 |
| 缓存和重新验证 | 数据请求和页面的缓存策略(`revalidate`、按路径 / 标签失效等),不同版本默认值不同,以官方文档为准 |
**边界原则**:尽量让组件保持为服务端组件,只把需要交互的“叶子”做成客户端组件,减少浏览器端的 JS;不能把函数、类实例作为 props 从服务端组件传给客户端组件(必须可序列化)。
### 用 Next.js 做 AI 接口
路由处理器中调用模型的流式接口,返回 `ReadableStream`;模型密钥只在服务端;用 `request.signal` 感知用户断开并停止生成。复杂的 Agent 逻辑仍然建议放在 Python 服务中,Next.js 作为 BFF(面向前端的后端)转发和鉴权。
## 案例
帮助中心:常见问题由服务端组件渲染(构建时静态生成,SEO 好);智能客服是客户端组件,调用 `/api/chat` 路由处理器,后者流式返回答案。构建结果中 `/` 是静态页面,`/api/chat` 是按需执行的动态路由。
## 代码示例
完整项目:[examples/next-ai-chat](examples/next-ai-chat/)(`npm install && npm run build` 已构建通过,`next start` 后实际请求验证)。
路由处理器([app/api/chat/route.ts](examples/next-ai-chat/app/api/chat/route.ts)):
```ts
export async function POST(request: Request): Promise<Response> {
const { question } = (await request.json()) as { question?: unknown };
if (typeof question !== "string" || question.length === 0 || question.length > 500) {
return Response.json({ error: "question 必须是 1~500 字的字符串" }, { status: 400 });
}
const encoder = new TextEncoder();
const stream = new ReadableStream<Uint8Array>({
async start(controller) {
try {
for await (const token of fakeLLM(question, request.signal)) { // signal:用户断开就停止
controller.enqueue(encoder.encode(token));
}
} finally {
controller.close();
}
},
});
return new Response(stream, { headers: { "Content-Type": "text/plain; charset=utf-8", "X-Accel-Buffering": "no" } });
}
```
服务端组件页面 + 客户端组件([app/page.tsx](examples/next-ai-chat/app/page.tsx)、[app/chat.tsx](examples/next-ai-chat/app/chat.tsx)):
```tsx
// app/page.tsx —— 服务端组件:取数和渲染都在服务器
export default async function Page() {
const faqs = await getFaqs();
return (
<main>
{faqs.map((f) => <details key={f.id}><summary>{f.q}</summary><p>{f.a}</p></details>)}
<Chat /> {/* 客户端组件 */}
</main>
);
}
// app/chat.tsx
"use client";
export function Chat() { const [answer, setAnswer] = useState(""); /* fetch + 读取流 */ }
```
构建输出:
```text
Route (app)
┌ ○ /
├ ○ /_not-found
└ ƒ /api/chat
○ (Static) prerendered as static content
ƒ (Dynamic) server-rendered on demand
```
## 易错点
- 在服务端组件中使用 `useState` 或事件处理,或者忘了写 `"use client"`。
- 把整个页面都标记为 `"use client"`,失去服务端组件的好处。
- 在客户端组件中导入了只能在服务端使用的模块(数据库客户端、密钥)。
- 以为缓存行为和上个版本一样:升级大版本前阅读升级指南。
- 部署在 Nginx 后面时流式响应被缓冲。
- 把复杂的 Agent 长任务放在路由处理器中执行,受函数超时限制(尤其是 Serverless 部署)。
## 面试常问
- 服务端组件和客户端组件的区别?边界怎么划分?
- Next.js 的路由处理器和 Server Actions 分别用在哪里?
- 用 Next.js 做 AI 应用的流式接口要注意什么?
@@ -0,0 +1,35 @@
// 不自动运行(Next.js 路由处理器,npm run dev 后 POST /api/chat)
// 服务端调用大模型并以流的形式返回;模型密钥只在服务端,浏览器拿不到。
export const runtime = "nodejs";
async function* fakeLLM(question: string, signal: AbortSignal): AsyncGenerator<string> {
// 真实项目:调用模型 SDK 的流式接口,并把 signal 传进去
const words = `关于“${question}”:签收 7 天内可以无理由退货。`.split("");
for (const w of words) {
if (signal.aborted) return; // 用户停止或断开:不再继续生成(节省费用)
await new Promise((r) => setTimeout(r, 30));
yield w;
}
}
export async function POST(request: Request): Promise<Response> {
const { question } = (await request.json()) as { question?: unknown };
if (typeof question !== "string" || question.length === 0 || question.length > 500) {
return Response.json({ error: "question 必须是 1~500 字的字符串" }, { status: 400 });
}
const encoder = new TextEncoder();
const stream = new ReadableStream<Uint8Array>({
async start(controller) {
try {
for await (const token of fakeLLM(question, request.signal)) {
controller.enqueue(encoder.encode(token));
}
} finally {
controller.close();
}
},
});
return new Response(stream, {
headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-cache", "X-Accel-Buffering": "no" },
});
}
@@ -0,0 +1,45 @@
"use client";
// 不自动运行
// 客户端组件:有状态和事件处理。读取路由处理器返回的流,逐段显示。
import { useRef, useState } from "react";
export function Chat() {
const [answer, setAnswer] = useState("");
const [busy, setBusy] = useState(false);
const ctrl = useRef<AbortController | null>(null);
async function ask(formData: FormData) {
ctrl.current?.abort();
ctrl.current = new AbortController();
setAnswer("");
setBusy(true);
try {
const resp = await fetch("/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ question: formData.get("q") }),
signal: ctrl.current.signal,
});
if (!resp.body) throw new Error("没有响应体");
const reader = resp.body.pipeThrough(new TextDecoderStream()).getReader();
for (;;) {
const { value, done } = await reader.read();
if (done) break;
setAnswer((a) => a + value);
}
} catch (e) {
if ((e as Error).name !== "AbortError") setAnswer("出错了,请重试");
} finally {
setBusy(false);
}
}
return (
<form action={ask}>
<input name="q" placeholder="问点什么" required />
<button disabled={busy}>发送</button>
{busy && <button type="button" onClick={() => ctrl.current?.abort()}>停止</button>}
<p aria-live="polite">{answer}</p>
</form>
);
}
@@ -0,0 +1,10 @@
// 不自动运行
export const metadata = { title: "帮助中心", description: "常见问题和智能客服" };
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="zh-CN">
<body>{children}</body>
</html>
);
}
@@ -0,0 +1,36 @@
// 不自动运行
// 服务端组件(默认):在服务器上取数和渲染,HTML 直接包含常见问题,对 SEO 友好;不会把这段代码发到浏览器。
import { Chat } from "./chat";
interface Faq {
id: number;
q: string;
a: string;
}
async function getFaqs(): Promise<Faq[]> {
// 真实项目:await fetch("https://cms.example.com/faqs", { next: { revalidate: 300 } })(缓存策略以官方文档为准)
return [
{ id: 1, q: "多久内可以退货?", a: "签收 7 天内可以无理由退货。" },
{ id: 2, q: "怎么开发票?", a: "在订单详情页申请电子发票。" },
];
}
export default async function Page() {
const faqs = await getFaqs();
return (
<main>
<h1>帮助中心</h1>
<section>
{faqs.map((f) => (
<details key={f.id}>
<summary>{f.q}</summary>
<p>{f.a}</p>
</details>
))}
</section>
{/* 交互部分是客户端组件,只有它的 JS 会发到浏览器 */}
<Chat />
</main>
);
}
@@ -0,0 +1,6 @@
// 不自动运行(Next.js 项目配置,npm install 后 npm run build)
import type { NextConfig } from "next";
const nextConfig: NextConfig = {};
export default nextConfig;
@@ -0,0 +1,7 @@
{
"name": "next-ai-chat",
"private": true,
"scripts": { "dev": "next dev", "build": "next build", "start": "next start" },
"dependencies": { "next": "^16.4.0", "react": "^19.2.0", "react-dom": "^19.2.0" },
"devDependencies": { "@types/node": "^24", "@types/react": "^19", "@types/react-dom": "^19", "typescript": "^5.9" }
}
@@ -0,0 +1,36 @@
{
"compilerOptions": {
"target": "ES2022",
"lib": [
"dom",
"dom.iterable",
"esnext"
],
"strict": true,
"noEmit": true,
"module": "esnext",
"moduleResolution": "bundler",
"jsx": "react-jsx",
"isolatedModules": true,
"skipLibCheck": true,
"plugins": [
{
"name": "next"
}
],
"allowJs": true,
"incremental": true,
"esModuleInterop": true,
"resolveJsonModule": true
},
"include": [
"next-env.d.ts",
"**/*.ts",
"**/*.tsx",
".next/types/**/*.ts",
".next/dev/types/**/*.ts"
],
"exclude": [
"node_modules"
]
}
+29 -3
View File
@@ -4,12 +4,38 @@ title: SSR(Nuxt / Next.js)
type: index
domain: frontend
stack: [ssr]
tags: []
tags: [SSR, SSG, 水合, Next.js, Nuxt]
week: [7]
---
# SSR(Nuxt / Next.js)
CSR / SSR / SSG、水合、Nuxt 与 Next.js 基础。
渲染模式和水合原理(面试常问),以及 Next.js App Router(前端出身做全栈的常见选择,BOSS直聘 2026-10-23 的调研中有岗位明确提到)。
> 本专题建设中:课程、企业场景、面试题和示例代码会陆续补充。
## 学习路线
| 顺序 | 课程 | 级别 | 预计 |
| --- | --- | --- | --- |
| 1 | [渲染模式:CSR / SSR / SSG / ISR、水合、流式渲染和 Nuxt 基础](01-rendering-modes.md) | 进阶 | 2.5 小时 |
| 2 | [Next.js App Router:服务端组件、客户端组件、路由处理器做 AI 流式接口、缓存](02-nextjs-app-router.md) | 进阶 | 3 小时 |
## 企业场景
- [帮助中心 + 智能客服:SEO、渲染模式组合和 BFF 设计](scenarios/help-center.md)
## 面试题
- [SSR 与 Next.js 面试题](interview.md)
## 示例代码
- [examples/next-ai-chat](examples/next-ai-chat/):Next.js 16 最小项目——服务端组件渲染常见问题、客户端组件对话框、路由处理器流式返回并响应断开(`npm install && npm run build` 构建通过)
## 在 16 周计划中
- [第 7 周:前端工程化查漏](../../../plan/week07-frontend.md)
## 官方资料
- Next.js:https://nextjs.org/docs
- Nuxt:https://nuxt.com/docs
+67
View File
@@ -0,0 +1,67 @@
---
id: frontend.ssr.interview
title: SSR 与 Next.js 面试题
type: interview
domain: frontend
stack: [ssr]
tags: [SSR, Next.js, Nuxt, 水合, 面试]
level: intermediate
related: [frontend.ssr.rendering-modes, frontend.ssr.nextjs-app-router]
week: [7, 16]
---
# SSR 与 Next.js 面试题
## 基础
### 【基础】CSR、SSR、SSG、ISR 有什么区别?
**参考答案**:区别在于 HTML 在哪里、什么时候生成:CSR 在浏览器;SSR 每次请求在服务器;SSG 在构建时;ISR 构建时生成并在过期后后台重新生成。按 SEO 需求、数据更新频率、个性化程度选择,一个站点可以混用。
**追问**:后台管理系统需要 SSR 吗?→ 一般不需要,没有 SEO 需求,CSR 更简单。
### 【基础】什么是水合?为什么会出现水合不匹配?
**参考答案**:浏览器加载 JS 后把交互能力附加到服务端渲染的 HTML 上。服务端和客户端第一次渲染结果不一致时出现不匹配,常见原因:时间、随机数、浏览器专有 API、时区和语言差异、无效的 HTML 嵌套。
**追问**:怎么修复?→ 浏览器专有逻辑放到挂载后执行,保证首次渲染两端一致;确实无法一致的地方使用框架提供的“仅客户端渲染”组件。
### 【基础】Next.js 中服务端组件和客户端组件的区别?
**参考答案**:服务端组件默认,在服务器上运行,可以直接访问数据和密钥,不增加浏览器端 JS,但不能使用状态和事件;客户端组件用 `"use client"` 声明,可以交互,会打包到浏览器。服务端组件可以渲染客户端组件,传递的 props 必须可序列化。
**追问**:边界怎么划分?→ 尽量把客户端组件下沉到需要交互的叶子节点。
## 进阶
### 【进阶】SSR 应用有哪些常见的坑?
**参考答案**:服务端访问浏览器 API;全局单例状态导致跨请求数据串用;个性化页面被 CDN 缓存;慢接口拖慢首屏;内存泄漏(服务端长期运行);环境变量误暴露到客户端。
**追问**:跨请求状态污染怎么避免?→ 每个请求创建新的 store 实例(Pinia、Redux),不使用模块级可变变量保存用户数据。
### 【进阶】Next.js 的路由处理器和 Server Actions 怎么选?
**参考答案**:路由处理器是标准的 HTTP 接口,适合给外部调用、Webhook、流式响应;Server Actions 适合表单提交和页面内的数据变更,可以直接在组件中调用并配合重新验证缓存。两者都要做鉴权和输入校验。
**追问**:Server Actions 安全吗?→ 它本质上也是公开的 HTTP 端点,必须校验身份、权限和参数,不能因为“只在页面里调用”就省略。
### 【进阶】什么是流式 SSR?
**参考答案**:服务器先发送页面外壳和已就绪的部分,慢数据对应的部分用 Suspense 边界包裹,准备好后通过同一个响应继续发送并插入页面。首字节和首屏更快,慢接口不阻塞整页。
**追问**:和 AI 的流式输出是一回事吗?→ 不是。流式 SSR 是页面 HTML 的分块发送;AI 流式输出是接口逐步返回生成的内容,两者可以同时使用。
## 场景题
### 【场景题】公司帮助中心 SEO 很差,同时要加智能客服,你怎么做?
**参考答案**:用 Next.js / Nuxt 重建,文章 SSG + 按需重新验证,个人页面动态渲染且禁止公共缓存;智能客服为客户端组件,通过 BFF 路由处理器鉴权、限流后转发到 AI 服务并透传流。详见[帮助中心场景](scenarios/help-center.md)。
**追问**:文章更新后多久能被看到?→ 取决于重新验证策略:基于时间的会有延迟;CMS 回调触发按路径重新验证可以做到几乎实时。
### 【场景题】Next.js 应用上线后,首屏可见但几秒内点击无反应,为什么?
**参考答案**:HTML 已经显示,但客户端 JS 还没加载和水合完成。排查:客户端组件过多、包体积大、第三方脚本阻塞、主线程长任务。优化:减少客户端组件、拆包和懒加载、延迟加载第三方脚本、关注 INP 指标。
**追问**:怎么量化?→ 看 Core Web Vitals 中的 INP 和 TBT,以及包体积分析报告。
@@ -0,0 +1,82 @@
---
id: frontend.ssr.scenario.help-center
title: 帮助中心 + 智能客服:SEO、渲染模式组合和 BFF 设计
type: scenario
domain: frontend
stack: [ssr, react, nginx, fastapi]
tags: [SEO, SSG, ISR, BFF, 流式接口, 鉴权, CDN 缓存]
level: intermediate
prerequisites: [frontend.ssr.nextjs-app-router]
est_hours: 2.5
related: [frontend.ssr.interview, devops.nginx.scenario.ai-gateway-sse-canary]
week: [7]
---
# 帮助中心 + 智能客服:SEO、渲染模式组合和 BFF 设计
## 业务背景与问题
公司的帮助中心是一个 Vue 单页应用,搜索引擎几乎收录不到文章;新增的智能客服直接从浏览器调用 Python 的 AI 服务,出现:
1. 帮助文章在搜索引擎中找不到,客服电话量居高不下;
2. AI 服务的地址和临时令牌暴露在前端代码中;
3. 文章更新后要重新部署整个前端;
4. 用户在 CDN 上看到了别人的“我的工单”页面。
## 约束
- 文章由运营在 CMS 中维护,每天更新几十篇。
- AI 服务(FastAPI + LangGraph)由另一个团队维护。
## 方案设计
1. **Next.js 重建帮助中心**:
- 文章页:静态生成 + 按时间或 CMS 回调(webhook)按路径重新验证,SEO 好、更新快;
- 首页和分类页:静态生成;
- “我的工单”:动态渲染,禁止 CDN 缓存(`Cache-Control: private, no-store`);
- 智能客服:客户端组件。
2. **BFF**:Next.js 的路由处理器作为 BFF,校验用户会话,转发到 AI 服务(服务间凭证只在服务端),透传流式响应;限流防刷。
3. **SEO**:每篇文章生成标题、描述、结构化数据;生成站点地图。
4. **部署**:Next.js 以 Node 服务部署在 Nginx 后,静态资源走 CDN;Nginx 对 `/api/chat` 关闭缓冲。
## 关键代码
BFF 转发流式响应(示意):
```ts
// app/api/chat/route.ts
export async function POST(request: Request) {
const user = await getSessionUser(request); // 校验登录态
if (!user) return Response.json({ error: "未登录" }, { status: 401 });
if (!(await rateLimit(`chat:${user.id}`, 20, 60))) return Response.json({ error: "请求过于频繁" }, { status: 429 });
const upstream = await fetch(`${process.env.AI_SERVICE_URL}/chat`, {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: `Bearer ${process.env.AI_SERVICE_TOKEN}`, "X-User-Id": user.id },
body: await request.text(),
signal: request.signal, // 用户断开时取消上游请求
});
return new Response(upstream.body, { status: upstream.status, headers: { "Content-Type": "text/event-stream", "Cache-Control": "no-cache" } });
}
```
可运行的最小项目:[examples/next-ai-chat](../examples/next-ai-chat/)。
## 取舍
| 选择 | 优点 | 缺点 |
| --- | --- | --- |
| **Next.js SSG/ISR + BFF(本方案)** | SEO、性能、安全兼顾 | 多了一个 Node 服务要运维 |
| 保持 SPA + 预渲染服务 | 改动小 | 预渲染服务维护麻烦,效果一般 |
| Nuxt | 团队熟悉 Vue | 同样可行;选择取决于团队技术栈 |
| 浏览器直连 AI 服务 | 少一跳 | 凭证暴露、难以统一鉴权和限流 |
## 易错点
- 动态的个人页面被 CDN 缓存。
- BFF 把上游的流读完再返回,失去流式效果。
- 服务间令牌用 `NEXT_PUBLIC_` 前缀的环境变量(会被打包进浏览器代码)。
- CMS 回调触发重新验证的接口没有鉴权。
## 面试怎么讲
> “帮助中心我用 Next.js 重做:文章页静态生成,CMS 更新时通过回调按路径重新验证,SEO 和更新速度都解决了;我的工单是动态页面,明确禁止 CDN 缓存。智能客服前端是客户端组件,调用 Next.js 的路由处理器做 BFF:校验会话、限流,用服务端的凭证转发到 Python 的 AI 服务,直接透传流式响应,用户断开时通过 signal 取消上游。”