Сначала подтвердите связь: добавьте span вокруг каждого внешнего fetch и сравните его завершение с Time To First Byte страницы. Если shell не отправляется до ответа одного API, решите, нужны ли эти данные для первого экрана. Отзывы, рекомендации и виджеты обычно можно отложить; цена и право доступа часто требуют строгого ответа.

У внешней зависимости должен быть deadline короче общего лимита SSR. «Подождать до timeout платформы» оставляет системе ноль времени на fallback и логирование. Конкретное число выбирают по пользовательскому бюджету, p95/p99 upstream и стоимости ошибки, а не копируют из примера.

Бюджет показывает, где страница теряет время

ЭтапНаблюдаемый сигналРешение
DNS/TCP/TLSДолго до ответа upstreamConnection reuse, сеть, регион
Upstream TTFBСоединение есть, headers нетDeadline, fallback, владелец API
Чтение bodyHeaders быстрые, payload медленныйЛимит размера, streaming/partial API
Server renderДанные готовы, HTML поздноПрофилирование component/serialization
Proxy bufferingПриложение пишет chunk, клиент ждётПроверить reverse proxy/CDN

Fetch заканчивается раньше общего запроса

async function loadRecommendations(productId) {
  const response = await fetch(
    `https://api.example.test/recommendations/${productId}`,
    { signal: AbortSignal.timeout(1500), cache: "no-store" }
  );
  if (!response.ok) throw new Error(`upstream ${response.status}`);
  return response.json();
}

URL и 1500 ms условны. Node.js документирует AbortSignal.timeout как сигнал, который автоматически abort через заданное число миллисекунд; в документации указано появление API в Node 17.3 и 16.14. Сверьте runtime проекта. Abort прекращает ожидание вашего fetch, но не гарантирует отмену вычислений на стороне чужого сервиса.

Не ставьте одинаковый timeout на критичный профиль пользователя и необязательные рекомендации. У каждого вызова есть владелец, fallback и доля общего бюджета. Параллельные запросы запускаются вместе, если между ними нет зависимости; последовательный await создаёт waterfall даже при быстром API.

Streaming помогает только некритичной части

Next.js App Router предлагает loading.js и Suspense, чтобы отправлять UI частями. Граница должна охватывать компонент, который действительно ждёт runtime/uncached data. Если медленный fetch находится выше — например, в layout до границы, — navigation всё равно блокируется.

  • Shell содержит навигацию, основной заголовок и данные, без которых нельзя честно показать страницу.
  • Некритичный блок получает skeleton и отдельную обработку timeout/error.
  • Fallback объясняет недоступность блока, а не изображает вечную загрузку.
  • Hydration не запускает второй бесконтрольный fetch тех же данных.
  • Proxy и CDN пропускают chunks; buffering проверяется по сети, а не предполагается.

Cache и stale-ответ требуют границ свежести

Для каталожных рекомендаций допустим последний успешный ответ с возрастом и коротким stale window. Для остатка, персональных прав или динамической цены старые данные могут быть опасны. Не включайте общий cache «ради скорости»: задайте key, tenant/locale, TTL, допустимый stale age и поведение при miss.

Если upstream восстановился, кеш не должен скрывать его бесконечно. Записывайте hit/miss/stale и age. Circuit breaker уменьшает лавину вызовов во время отказа, но имеет half-open probe и не заменяет deadline каждого запроса.

Проверка искусственно замедляет ровно одну зависимость

  1. Добавить контролируемую задержку mock/staging upstream без изменения остальных сервисов.
  2. Измерить TTFB, время shell и появление отложенного блока.
  3. Подтвердить abort по deadline и отсутствие незавершённых socket/request leaks.
  4. Повторить через production-like proxy, проверяя фактические chunks.
  5. Вернуть API в норму и убедиться, что circuit/cache снова отдают свежий путь.

Успешный результат виден в двух метриках

После исправления TTFB критичного shell не повторяет хвост latency необязательного API, а доля fallback соответствует реальным timeout/error этого сервиса. Отдельно следите за общей длительностью SSR: быстрый shell не оправдывает зависший stream без конечного состояния.

Для анализа подготовьте route, версию Next.js и Node.js, trace/span durations, cache mode, proxy chain и HAR без cookies/токенов. По ним можно понять, где поставить deadline и границу, не превращая ошибку данных в безусловный stale-ответ.

Проверенные источники