开发2024年8月22日8 分钟阅读#nextjs#architecture#performance

用 Next.js 构建高弹性系统

现代 Web 应用中高可用性与高性能的最佳实践。

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

架构优先

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');
}

我遵守两条规则:

  1. 绝不重试 4xx。 404 重试也是 404。
  2. 限制总等待时长。 用户盯着 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——都要事先设计好故障模式。早点做好这些,原本会变成宕机的事故,就只是没人察觉到的静默降级。

动画头像视频
Yakushev Hermann
愿景型创始人 · 资深 Agentic AI 架构师 · 社交人脉

更多文章

y7.hk 现代工程文章渲染解剖

对 y7 阅读引擎的压力测试:callout 提示块、diff 代码块、KaTeX 公式、圆形头像视频、figure 图库、折叠剧透和字体切换器。

2026年10月15日 · 5 分钟阅读

生活在时区之间

67 个国家和四个常驻基地教会我的事:深度工作、时差反应,以及打造没人要求你做的产品。

2026年7月18日 · 6 分钟阅读