218 КБ словаря в каждой странице: как найти и вычистить раздутый payload в NuxtСтатья · дайджест за 10 ноября
Рентгеновский разрез структуры веб-документа, выявляющий скрытые блоки данных внутри страницы
Статья4 раздела≈ 8 мин

218 КБ словаря в каждой странице: как найти и вычистить раздутый payload в Nuxt

В ноябрьском аудите 36 продакшен-сайтов из витрины Nuxt Showcase меня зацепила одна цифра: медианный размер скрытого блока состояния внутри документа составляет 93 КБ, съедая 29% объема разметки. Обычно виновников медленной загрузки ищут среди тяжелых картинок или бандлов, считая HTML легким каркасом. Но на деле у 17 проектов этот довесок превышает желтый порог в 100 КБ, у 6 сайтов пробивает красную отметку в 500 КБ, а несколько крупных магазинов пересылают в разметке главной от 120 до 280 КБ словарей локализации.

В такую же ловушку попала киберспортивная платформа BIGPLAY на Nuxt: лаконичная главная разрослась больше чем на полмегабайта текста, хотя гостю на ней нужно показать лишь пару десятков фраз. Разберемся, как гидратация превращает состояние в сетевой балласт, как просветить сайт через утилиту nuxt-payload-xray и как вынести переводы в вечный кэш.

Невидимый груз гидратации: зачем Nuxt прячет состояние внутри HTML

При серверном рендеринге (Server-Side Rendering) браузер сразу получает готовую верстку. Следом загружается клиентский JavaScript, которому нужно «оживить» страницу — привязать обработчики кликов и запустить меню. Этот шаг называется гидратацией.

Это как отправка собранного конструктора по почте: чтобы ты сразу переключал рычаги без звонков на завод, в коробку кладут опись настроек. Без этих данных браузеру после загрузки скриптов пришлось бы заново опрашивать бэкенд, вызывая мигание экрана. Поэтому фреймворк собирает состояние из useState, useAsyncData, useFetch и сторов и пишет их в конец HTML внутри <script type="application/json" id="__NUXT_DATA__">.

Внутри тега данные лежат как плоский массив со ссылками по индексам: нулевой элемент указывает на корень, а повторяющиеся строки пишутся один раз. Дедупликация экономит место на повторах, но запускает цепочку:

  • если во время серверного запроса ты кладешь в состояние справочник или весь ответ API, сериализатор упаковывает его в массив целиком;
  • если блок вшит в HTML, браузер не кэширует его между визитами как статический скрипт — при обновлении вкладки или переходе из поиска весь объем качается заново;
  • а если до гидратации браузер должен распарсить сотни килобайт JSON в основном потоке процессора, на смартфонах интерфейс замирает.

При разработке заметить это трудно: при переходах через NuxtLink новый HTML не запрашивается, а данные берутся из памяти. На ноутбуке инженера все летает, пока пользователи из поиска ждут загрузки тяжелой разметки.

Рентген серверного ответа: как nuxt-payload-xray вычисляет тяжелые ключи

Стандартные аудиторы скорости лишь жалуются на большой HTML, не называя виновный ключ в __NUXT_DATA__. Встроенная панель отладки Nuxt подсвечивает вес ключей только локально в dev-режиме, а анализаторы статики проверяют _payload.json лишь при сборке через nuxt generate.

Разработчик BIGPLAY Даурен под ником dadashi44 в разборе на Хабре рассказал, как написал для проверки живых серверов утилиту nuxt-payload-xray. Она обращается к странице по URL без доступа к коду, находит __NUXT_DATA__, проходит по ссылкам массива от ключей data, state и pinia и считает вес каждой ветки.

Проверим через терминал самые тяжелые ключи на живом сайте и зададим лимит веса для тестового стенда в CI/CD:

# Инспекция самых тяжелых ключей payload на живой странице
npx nuxt-payload-xray https://nuxt.com --top 10

# Проверка лимита веса в CI/CD с возвратом кода ошибки при превышении
npx nuxt-payload-xray "$PREVIEW_URL" --max 150kb

Первая команда скачивает разметку и выводит диаграмму: сырой и сжатый в gzip размер пакета, долю от HTML и рейтинг ключей. Вторая команда с флагом --max страхует сборку: если страница на превью-стенде превысит планку 150kb, скрипт вернет код ошибки 1 и остановит выкатку.

Показателен замер самого сайта nuxt.com: пакет данных весит 196,6 КБ или 51,3 КБ в gzip — это 36% от документа на 546,3 КБ. Лидирует ключ data: navigation:4.x на 77,7 КБ, далее идут data: index на 49,6 КБ и data: official-modules на 40,4 КБ. Внутри navigation:4.x лежит меню из 429 разделов документации для мгновенного поиска по Ctrl+K. Отсюда правило: большой ключ, который нужен странице целиком, — честная цена за функцию; большой ключ, из которого нужна малая доля, — ошибка.

Ловушка локализации: как словарь всего сайта попадает в каждую страницу

Когда Даурен просканировал главную BIGPLAY до оптимизации, несжатый HTML весил 658 КБ, из которых 271 КБ занимал пакет гидратации. Внутри лежал ключ translations на 218 КБ — 2271 строка переводов всех разделов портала, включая личный кабинет и настройки профиля.

Причина крылась в обманчиво удобной схеме: серверный middleware забирал переводы из внешнего сервиса, а плагин клал их в useState('translations'), чтобы локализация работала на сервере и клиенте. Поскольку useState синхронизирует данные с браузером, фреймворк сериализовал весь словарь в каждую страницу.

Тексты интерфейса меняются редко, поэтому словарь вынесли в отдельный файл. Сервер считает SHA-1 хеш словаря и отдает его по адресу /i18n/ru.<хеш>.json с заголовком Cache-Control: public, max-age=31536000, immutable, кэшируя файл на год.

Посмотрим, как изменился код: вместо словаря в useState остается короткий хеш версии, а в <head> добавляется предзагрузка файла:

// Было: весь словарь попадает в useState и сериализуется в HTML
// const translations = useState('translations', () => ({}))

// Стало: в payload хранится только короткий SHA-1 хеш версии словаря
const translationVersion = useState('i18n_ver', () => 'a1b2c3d4e5f6')

useHead({
  link: [
    {
      rel: 'preload',
      href: `/i18n/ru.${translationVersion.value}.json`,
      as: 'fetch',
      crossorigin: 'anonymous'
    }
  ]
})

Теперь в __NUXT_DATA__ уезжает строка 'a1b2c3d4e5f6' из двенадцати символов. Сервер рендерит HTML с полным словарем из памяти для поисковиков, а <link rel="preload" as="fetch"> заставляет браузер качать JSON параллельно с документом. Я специально обратил внимание на атрибут crossorigin="anonymous": без него режим CORS не совпадет с fetch(), и браузер скачает словарь дважды. О предзагрузке ресурсов по маршрутам я также рассказывал в статье Экосистема Nuxt: предзагрузка шрифтов по маршрутам и ускорение рендеринга иконок.

При выкатке обошли еще две ловушки. Во-первых, файл нельзя класть в /api/, если путь закрыт в robots.txt: иначе Googlebot не скачает словарь и проиндексирует сырые ключи — поэтому выбрали /i18n/. Во-вторых, HTML из серверного кэша может запросить устаревший хеш после обновления переводов — о правилах кэширования я писал в разборе Nuxt v4.6.4: срочный релиз безопасности, проверка хостов и новые правила кэширования Nitro. Чтобы страницы не ломались, сервер держит последние версии словаря в памяти, а на неизвестный хеш отдает актуальный словарь с Cache-Control: no-store.

Результаты на продакшене и разумный предел оптимизации

Повторный прогон nuxt-payload-xray на bigplay.gg показал чистую картину: несжатый HTML главной сократился до 191,6 КБ, а блок гидратации — до 55,9 КБ или 15,7 КБ в gzip, тогда как в сводке тестового замера объем ужался с 256 до 47 КБ. Теперь 97% пакета — 54,3 КБ — занимает ключ data: home-page-ru с турнирами и баннерами, а сторы pinia: tournamentsPageStore и pinia: translationState весят 172 Б и 132 Б.

На прод-сборке в gzip выигрыш по маршрутам выглядит так:

Страница порталаВес HTML: было → сталоВес payload: было → стало
Главная112 КБ → 59 КБ66 КБ → 12 КБ
Английская версия /en96 КБ → 58 КБ50 КБ → 12 КБ
Список турниров101 КБ → 48 КБ56 КБ → 3 КБ

На первом визите экономия по сети почти нулевая, так как словарь весом 53 КБ в gzip качается отдельным файлом. Зато на повторных заходах словарь берется из кэша за 0 байт, урезая вес страницы вдвое.

Меня в этом кейсе подкупает расчет автора, почему не стоит резать словарь дальше под каждую страницу:

  • Если делить по разделам, то шапка, футер и модалки есть везде и тянут 68–82% словаря.
  • Если делить по ключам, странице нужно 21–32% строк, но статически в коде находится лишь 58% ключей — остальные собираются динамически, и промах парсера покажет пользователю сырой tournament_page.xxx.
  • Если сравнить потоки загрузки, словарь качается параллельно с JS-бандлом главной страницы весом 317 КБ в gzip. Интерактивность наступает после загрузки JS, поэтому ужимание словаря не ускорит отклик.

Чтобы держать серверный ответ в тонусе на своих проектах, ориентируйся на три рабочих принципа:

  • Просвечивай страницы по URL: запускай npx nuxt-payload-xray <url> на ключевых маршрутах и сверяй, какая доля тяжелых ключей видна на экране.
  • Отсекай лишние поля API: в useFetch('/api/tournaments', { pick: ['id', 'title', 'startDate'] }) забирай через pick только нужные шаблону поля и не складывай в сторы весь ответ бэкенда.
  • Выноси статику из useState: редко меняющиеся переводы, справочники и конфиги отдавай отдельными файлами с кэшированием по хешу.

Первый шаг забрал почти всю выгоду без риска сломать интерфейс, а умение вовремя остановиться и не строить хрупкий парсер ради копеечной экономии — лучшее проявление инженерного прагматизма.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2