Если Москва иногда видит наличие Екатеринбурга, ошибка уже не сводится к «старому кешу». Вариант ответа зависит от региона, но один из слоёв сохранил его под ключом без этого измерения. Первый запрос прогрел значение, второй получил чужой результат как cache hit.
Массовый purge временно уберёт симптом и одновременно уничтожит полезный кеш. Сохраните пару запросов A → B и найдите первый слой, где разные входы превратились в одинаковый ключ. Исправлять нужно модель ключа, а не частоту очистки.
Один ответ получает паспорт на каждом слое
| Слой | Какой ключ записать | Маркер ответа |
|---|---|---|
| CDN | scheme + host + path + variant | Age, X-Cache, POP |
| Reverse proxy | host/path/header map | upstream cache status |
| SSR/full page | route + region + locale | render id |
| Data cache | resource + region + version | source/cache tag |
| Backend API | явный region_id | resolved 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 + Vary | URL остаётся общим | Нужна строгая 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 подтверждает изоляцию
- На холодном кеше запросить регион A и сохранить body marker и headers.
- Тем же клиентом и отдельной чистой сессией запросить регион B.
- Снова запросить A: допустим HIT, но только с вариантом A.
- Повторить в разных POP или через bypass CDN, если он поддерживается безопасно.
- Проверить HTML document, RSC/data response и backend API отдельно.
- Изменить данные B и убедиться, что инвалидирован нужный регион, а A сохранился.
Исправление завершено, когда A-B-A стабильно возвращает свои варианты на HIT и MISS, cache key наблюдаем, а персональный ответ никогда не становится public. Для разбора нужны URL, нормализованный region_id, headers трёх ответов, конфигурация ключа и названия cache tags — cookie и пользовательские данные удалите.