Если Москва иногда видит наличие Екатеринбурга, ошибка уже не сводится к «старому кешу». Вариант ответа зависит от региона, но один из слоёв сохранил его под ключом без этого измерения. Первый запрос прогрел значение, второй получил чужой результат как cache hit.

Массовый purge временно уберёт симптом и одновременно уничтожит полезный кеш. Сохраните пару запросов A → B и найдите первый слой, где разные входы превратились в одинаковый ключ. Исправлять нужно модель ключа, а не частоту очистки.

Один ответ получает паспорт на каждом слое

СлойКакой ключ записатьМаркер ответа
CDNscheme + host + path + variantAge, X-Cache, POP
Reverse proxyhost/path/header mapupstream cache status
SSR/full pageroute + region + localerender id
Data cacheresource + region + versionsource/cache tag
Backend APIявный region_idresolved warehouse/price list

Добавьте в тестовый ответ безопасные технические заголовки вроде `X-Debug-Region: msk` и `X-Render-Id`, но не публикуйте внутренние адреса и user id. Если body уже неверен при MISS CDN, искать надо в приложении или data cache. Если origin верен, а edge HIT неверен, проблема в CDN key/policy.

Регион определяется до чтения кеша

// Условный серверный код: детали cache API зависят от версии фреймворка
const region = resolvePublicRegion({
  routeRegion: params.region,
  savedPreference: cookies().get('region')?.value,
  defaultRegion: 'msk',
})

assert(ALLOWED_REGIONS.has(region))
const cacheKey = ['catalog-summary', region, CATALOG_SCHEMA_VERSION]
const data = await cachedLoad(cacheKey, () => loadCatalog({ region }))

// В HTML и API используется тот же canonical region, а не повторное IP-определение.

Ключ строится из канонического идентификатора, а не из свободной строки заголовка. Если регион определяется по IP уже после cache lookup, первый вариант победит всегда. Правило приоритета — URL, сохранённый выбор, допустимый default — должно быть одинаковым в SSR и API.

Vary работает только при поддержке кеша

HTTP `Vary` сообщает кешу, какие request headers влияли на ответ. Например, `Vary: X-Region` требует хранить варианты отдельно. Но CDN должен действительно включать этот header в ключ; некоторые конфигурации игнорируют или ограничивают Vary. Для App Router также важно не удалять параметры и headers, которыми Next.js различает HTML, RSC и prefetch-варианты.

СпособПлюсОграничение
/msk/catalogВариант виден в URL и ключеНужны canonical/маршрутизация
X-Region + VaryURL остаётся общимНужна строгая CDN policy
Cookie регионаУдобен выбор пользователяShared cache легко смешать
IP на edgeНет выбора до первого визитаОшибки геолокации и непрозрачный key
Private/no-storeНет утечки вариантаМеньше cache hit и выше нагрузка

Персонализация не является ещё одним регионом

Региональная витрина может быть общей для тысяч посетителей, а персональная скидка, корзина и остаток по договору — нет. Не добавляйте Cookie целиком в Vary: это создаёт огромное число вариантов и всё равно требует понимания приватности. Если ответ зависит от авторизации или персональных данных, используйте private/no-store либо отделите общую оболочку от персонального запроса.

  • Не кешируйте HTML пользователя под публичным ключом региона.
  • Не доверяйте произвольному X-Region от браузера без allowlist и нормализации.
  • Не используйте название города в одном слое и внутренний UUID в другом без явного mapping.
  • Не меняйте Vary только на ответах 200: одинаковая политика нужна и для 304 того же URL.
  • Не очищайте все регионы, если изменился каталог одного региона и доступны cache tags.

Матрица A-B-A подтверждает изоляцию

  1. На холодном кеше запросить регион A и сохранить body marker и headers.
  2. Тем же клиентом и отдельной чистой сессией запросить регион B.
  3. Снова запросить A: допустим HIT, но только с вариантом A.
  4. Повторить в разных POP или через bypass CDN, если он поддерживается безопасно.
  5. Проверить HTML document, RSC/data response и backend API отдельно.
  6. Изменить данные B и убедиться, что инвалидирован нужный регион, а A сохранился.

Исправление завершено, когда A-B-A стабильно возвращает свои варианты на HIT и MISS, cache key наблюдаем, а персональный ответ никогда не становится public. Для разбора нужны URL, нормализованный region_id, headers трёх ответов, конфигурация ключа и названия cache tags — cookie и пользовательские данные удалите.

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