用 Next.js 构建高弹性系统
现代 Web 应用中高可用性与高性能的最佳实践。
TL;DR5
- 架构先于工具:弹性是设计层面的属性
- ISR 配合 stale-while-revalidate 能在后端宕机时保住页面
- 重试要带退避和抖动 — 熔断器切断级联故障
- 错误边界把故障隔离到出问题的组件,而不是整页
- 降级 UI 和离线容忍是一等功能,不是补丁

架构优先
Next.js 常作为现代 Web 应用的骨架。要保证弹性,既需要正确的架构决策,也需要合适的工具。
借助 Server Components 和完善的错误边界(error boundaries),你可以构建出能优雅降级而非整体崩溃的高弹性 Web 应用。
静态生成 vs SSR
尽可能默认使用增量静态再生(ISR)。这样即使后端 API 暂时不可用,用户依然能看到最近一次成功构建的页面版本。
但取舍是真实的 用新鲜度换弹性,SSR 用对后端的硬依赖换新鲜度。
// app/blog/[slug]/page.tsx
export const revalidate = 300; // 5 分钟
export default async function Post({ params }) {
const post = await fetchPost(params.slug); // 缓存 + 重新验证
return <Article post={post} />;
}
去年 Cloudflare 出事故时,我的源站 API 挂了 40 分钟。y7.hk 上所有 ISR 页面继续正常返回略显陈旧但合法的 HTML,而同站点的 SSR 页面直接 500。这次事故让我损失了 4% 的月流量,也永久改变了我对渲染策略的看法。
经验法则: 能容忍 5–60 分钟陈旧的内容用 ISR(博客文章、产品页、营销页)。只有当陈旧会破坏产品时才用 SSR(实时仪表盘、登录态、实时数据)。
错误边界是隔离舱壁
没有错误边界,一个组件崩溃会拖垮整页。有了边界,每个区块独立失败。
// app/components/Section.tsx
'use client';
import { Component, ReactNode } from 'react';
export class Section extends Component<
{ children: ReactNode; fallback?: ReactNode },
{ hasError: boolean }
> {
state = { hasError: false };
static getDerivedStateFromError() {
return { hasError: true };
}
render() {
if (this.state.hasError) {
return this.props.fallback ?? <div className="opacity-50">该区块暂不可用</div>;
}
return this.props.children;
}
}
把每个独立单元——侧栏挂件、评论区、分析面板——都包进自己的边界。用户看到的是一块灰色的占位,而不是空白页。
我在一个 Web3 仪表盘上踩过坑 RPC 超时直接崩掉了整个持仓视图。给价格组件加一个边界就能救下整场会话。
重试要带退避
盲目重试会放大故障。指数退避加抖动可以分散压力,给上游留出恢复时间。
async function fetchWithRetry<T>(
fn: () => Promise<T>,
attempts = 3,
baseDelay = 300
): Promise<T> {
for (let i = 0; i < attempts; i++) {
try {
return await fn();
} catch (err) {
if (i === attempts - 1) throw err;
const jitter = Math.random() * baseDelay;
await new Promise(r => setTimeout(r, baseDelay * 2 ** i + jitter));
}
}
throw new Error('unreachable');
}
我遵守两条规则:
- 绝不重试 4xx。 404 重试也是 404。
- 限制总等待时长。 用户盯着 spinner 超过 8 秒就展示 fallback,让他们继续操作。
熔断器切断级联故障
重试解决瞬时错误,熔断器解决持续性故障。后端连续失败 30 秒就别再锤它了——打开熔断,立刻返回降级响应。
class Breaker {
private failures = 0;
private openUntil = 0;
constructor(private threshold = 5, private cooldown = 30_000) {}
async call<T>(fn: () => Promise<T>): Promise<T> {
if (Date.now() < this.openUntil) throw new Error('Circuit open');
try {
const result = await fn();
this.failures = 0;
return result;
} catch (e) {
if (++this.failures >= this.threshold) {
this.openUntil = Date.now() + this.cooldown;
}
throw e;
}
}
}
没有熔断,慢上游会拖出一堆挂死的 Node 进程。有了熔断,失败快速返回,上游恢复时系统立即跟上。
边缘缓存 + stale-while-revalidate
Cache-Control 是最便宜的弹性层。stale-while-revalidate 让边缘节点先返回最后一次的缓存,同时在后台拉取新版本。
Cache-Control: public, s-maxage=60, stale-while-revalidate=600
这就是“API 挂 = 网站挂”和“API 挂 = 部分用户看到 10 分钟前的数据”的区别。
降级 UI 是功能
降级 UI 不是出了错才显示的东西,它是设计的一部分。每个异步区块都有三种状态:
- 加载中: 与最终布局一致的骨架屏(不产生布局偏移)。
- 成功: 真实内容。
- 错误: 仍能完成任务的降级版本。
价格挂件挂了不要亮红色错误——展示最近一次缓存的价格,加个小角标“12 分钟前更新”。评论系统挂了就只读展示并隐藏输入框。
离线容忍
Service Worker 不只是 PWA 的玩具。一个最小的 SW——缓存 app shell 加最近访问的 5 个页面——在酒店烂 Wi-Fi 和三万英尺的航班上提供真正的离线体验。对我而言,这种场景占比不小。
// sw.ts — 静态资源 cache-first,页面 network-first
self.addEventListener('fetch', (e) => {
const url = new URL(e.request.url);
if (url.pathname.startsWith('/_next/static/')) {
e.respondWith(caches.match(e.request).then(r => r ?? fetch(e.request)));
}
});
我真实踩过的坑
- Cloudflare KV 故障: 所有依赖 KV 的页面返回 500。ISR 页面存活。
- 流量高峰时上游 CMS 把我限流。 当时没有熔断,Next.js 不停打 CMS 直到我被硬封 IP。现在所有外部调用都走带 30 秒冷却的熔断器。
- 一个
<PriceTicker>组件搞挂整个仪表盘 —— WebSocket 一断全崩。加了边界后,其余 UI 继续运行,挂件在后台静默重连。
弹性清单
- 能容忍 5+ 分钟陈旧的内容用 ISR/SSG
- 每个可缓存路由都加
stale-while-revalidate - 每个独立挂件外面包错误边界
- 重试用指数退避 + 抖动;4xx 绝不重试
- 每个外部服务调用都过熔断器
- 每个异步 UI 都有骨架屏 + 降级 + 错误三态
- Service Worker 缓存 app shell
- 为非关键功能(分析、推荐)准备可文档化的 kill-switch
结语
弹性不是最后才贴上去的功能,它就是架构本身。每一层——渲染、缓存、请求、UI——都要事先设计好故障模式。早点做好这些,原本会变成宕机的事故,就只是没人察觉到的静默降级。
更多文章
y7.hk 现代工程文章渲染解剖
对 y7 阅读引擎的压力测试:callout 提示块、diff 代码块、KaTeX 公式、圆形头像视频、figure 图库、折叠剧透和字体切换器。
生活在时区之间
67 个国家和四个常驻基地教会我的事:深度工作、时差反应,以及打造没人要求你做的产品。
