Сначала подтвердите связь: добавьте span вокруг каждого внешнего fetch и сравните его завершение с Time To First Byte страницы. Если shell не отправляется до ответа одного API, решите, нужны ли эти данные для первого экрана. Отзывы, рекомендации и виджеты обычно можно отложить; цена и право доступа часто требуют строгого ответа.
У внешней зависимости должен быть deadline короче общего лимита SSR. «Подождать до timeout платформы» оставляет системе ноль времени на fallback и логирование. Конкретное число выбирают по пользовательскому бюджету, p95/p99 upstream и стоимости ошибки, а не копируют из примера.
Бюджет показывает, где страница теряет время
| Этап | Наблюдаемый сигнал | Решение |
|---|---|---|
| DNS/TCP/TLS | Долго до ответа upstream | Connection reuse, сеть, регион |
| Upstream TTFB | Соединение есть, headers нет | Deadline, fallback, владелец API |
| Чтение body | Headers быстрые, 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 каждого запроса.
Проверка искусственно замедляет ровно одну зависимость
- Добавить контролируемую задержку mock/staging upstream без изменения остальных сервисов.
- Измерить TTFB, время shell и появление отложенного блока.
- Подтвердить abort по deadline и отсутствие незавершённых socket/request leaks.
- Повторить через production-like proxy, проверяя фактические chunks.
- Вернуть 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-ответ.