Строим отказоустойчивые системы на Next.js
Лучшие практики высокой доступности и производительности в современных веб-приложениях.
TL;DR5
- Архитектура важнее инструментов: отказоустойчивость — свойство дизайна
- ISR с stale-while-revalidate держит страницы живыми при падении бэкенда
- Ретраям нужны backoff и jitter — circuit breaker обрывает каскадные сбои
- Error boundaries изолируют сбой конкретному виджету, а не всей странице
- Fallback UI и офлайн-толерантность — это фичи, а не патчи

Архитектура прежде всего
Next.js часто служит фундаментом современных веб-приложений. Отказоустойчивость требует и правильных архитектурных решений, и правильных инструментов.
Используя Server Components и корректные error boundaries, можно строить приложения, которые деградируют плавно вместо того, чтобы падать целиком.
Статическая генерация против SSR
По возможности выбирайте Incremental Static Regeneration (ISR). Это гарантирует, что даже при временной недоступности бэкенд-API пользователи увидят последнюю успешно собранную версию страницы.
Компромисс реален: ISR даёт устойчивость ценой свежести данных. 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} />;
}
Когда в прошлом году мой origin API лежал 40 минут из-за инцидента на Cloudflare, все ISR-страницы y7.hk продолжали отдавать устаревший, но валидный HTML. SSR-страницы того же сайта возвращали 500. Этот эксперимент стоил мне 4% месячного трафика — и навсегда изменил то, как я выбираю стратегию рендеринга.
Правило: ISR для всего, что может быть устаревшим на 5–60 минут (посты, карточки продуктов, маркетинг). SSR только когда устаревшие данные ломают продукт (дашборды, состояние авторизации, реалтайм-данные).
Error Boundaries — это переборки
Без boundaries один падающий виджет роняет всю страницу. С boundaries каждый блок падает независимо.
// 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;
}
}
Оборачивайте каждую независимую единицу — сайдбар, комментарии, аналитику — в свой boundary. Пользователь увидит серый прямоугольник вместо виджета, а не пустой экран.
Я это усвоил на Web3-дашборде, где один RPC-таймаут ронял весь портфель. Одна обёртка вокруг тикера цены спасла бы сессию.
Ретраям нужен backoff
Слепые ретраи усиливают сбой. Экспоненциальный backoff с jitter распределяет нагрузку и даёт апстриму время восстановиться.
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 не станет 200 на повторе.
- Ограничивайте общее ожидание. Если пользователь смотрит на спиннер 8+ секунд — покажите fallback и дайте работать дальше.
Circuit Breaker останавливает каскадные сбои
Ретраи решают временные ошибки. Circuit breaker — постоянные. Если бэкенд лежит 30 секунд, перестаньте его долбить — откройте circuit и отдавайте деградированный ответ сразу.
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;
}
}
}
Без breaker медленный апстрим превращается в парк повисших Node-процессов. С breaker вы получаете быстрый отказ и систему, которая восстановится сразу после апстрима.
Edge-кеш со stale-while-revalidate
Заголовок Cache-Control — самый дешёвый слой устойчивости. stale-while-revalidate позволяет edge отдавать последнюю кешированную копию, пока в фоне догружается свежая.
Cache-Control: public, s-maxage=60, stale-while-revalidate=600
Это разница между «API упал — сайт упал» и «API упал — часть пользователей видит данные 10-минутной давности».
Fallback UI как фича
Fallback — это не то, что вы показываете при сбое. Это часть дизайна. У каждого асинхронного блока три состояния:
- Загрузка: скелетон, совпадающий с финальной раскладкой (без layout shift).
- Успех: реальный контент.
- Ошибка: деградированная версия, которая всё ещё позволяет пользователю делать своё дело.
Если виджет цен упал, не показывайте красную ошибку — покажите последние закешированные цены с пометкой «обновлено 12 минут назад». Если комментарии упали — покажите read-only ленту и спрячьте форму ввода.
Офлайн-толерантность
Service Worker — это не только для PWA. Минимальный SW, кеширующий app shell и последние 5 посещённых страниц, даёт реальную офлайн-толерантность на флаки-вайфае отеля и на высоте 10 000 метров — что для меня, честно говоря, ощутимая доля браузинга.
// 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 зарейтлимитил меня на пике трафика. Breaker’а не было — Next.js долбил CMS до жёсткого IP-бана. Теперь каждый внешний вызов идёт через breaker с 30-секундным cooldown.
- Один
<PriceTicker>уронил весь дашборд при обрыве WebSocket. После добавления boundary остальной UI продолжил жить, пока тикер переподключался.
Чеклист отказоустойчивости
- ISR/SSG для контента, терпящего 5+ минут устаревания
-
stale-while-revalidateна каждом кешируемом роуте - Error boundary вокруг каждого независимого виджета
- Экспоненциальный backoff + jitter на ретраях; 4xx не ретраим
- Circuit breaker на каждом вызове внешнего сервиса
- Скелетон + fallback + состояние ошибки для каждого async UI
- Service worker, кеширующий app shell
- Задокументированный kill-switch для некритичных фич (аналитика, рекомендации)
Суть
Отказоустойчивость — не фича, которую прикручивают в конце. Это сама архитектура. Каждый слой — рендеринг, кеш, фетч, UI — получает продуманный режим отказа заранее. Заложите их рано, и инциденты, которые могли бы быть аутеджами, станут тихой деградацией, которую никто не заметит.
Ещё из блога
Анатомия современного инженерного текста на y7.hk
Стресс-тест движка чтения y7: коллауты, diff-блоки, KaTeX формулы, видеокружок, галерея figure, спойлеры и переключатель шрифтов.
Жизнь между часовыми поясами
Чему учат 67 стран и четыре домашние базы — про глубокую работу, джетлаг и продукты, которые никто не просил строить.
