Если CDN показывает старую картинку, перезагрузка страницы не доказывает, что edge-cache обновился: браузер может вообще не обращаться в сеть. Скопируйте точный URL изображения, получите его напрямую с origin и через CDN, сравните хеш содержимого, `Age`, `Cache-Control`, `ETag` и `Last-Modified`. Так станет видно, кто держит старую версию.

Для изображения, которое заменяется, самый надёжный выпуск — новый URL: например, `product-42.a81f2c.webp`. Сначала загрузите файл и проверьте его через CDN, затем обновите HTML/JSON. Старый URL можно долго кешировать и удалить позже; пользователи не зависят от скорости invalidation и локального browser cache.

Паспорт ответа отделяет origin от edge

curl -sS -D cdn.headers -o cdn.bin 'https://cdn.example.com/p/42/photo.webp'
curl -sS -D origin.headers -o origin.bin 'https://origin.example.net/p/42/photo.webp'
sha256sum cdn.bin origin.bin

# В заголовках сравнить: Age, Cache-Control, ETag, Last-Modified,
# Content-Length, Content-Type и провайдерский cache-status.

Если хеш origin уже новый, а CDN старый — изучайте cache key, TTL и invalidation. Если оба старые, публикация не дошла до origin либо URL ведёт в другой bucket/path. Если CDN отдаёт новый файл, а страница показывает старый, проверьте HTML, `srcset`, `<picture>`, service worker и memory cache браузера.

НаблюдениеГде застряла версияДействие
origin hash старыйpipeline/storageповторить атомарную загрузку и сверить key
origin новый, CDN Age растёт со старым hashedge cacheновый URL или точечная invalidation
CDN новый, HTML ссылается на прежний variantшаблон/API/srcsetобновить manifest/данные
Network не делает запросbrowser/service workerпроверить cache storage и политику SW
разные edge дают разные hashраспространение/ключ/несколько originsсверить POP и cache behavior

Cache-Control описывает срок свежести, а не приказ обновиться

RFC 9111 называет ответ fresh, пока его age не превысил freshness lifetime; свежий ответ может обслуживаться без origin. Для неизменяемого URL с хешем подходит длинный `max-age` и `immutable`. Для HTML/manifest, который переключает версии, нужен короткий срок или revalidation. Один и тот же URL с годовым TTL и регулярно меняющимися bytes — противоречивый контракт.

# Контент с fingerprint: bytes по URL никогда не меняются
Cache-Control: public, max-age=31536000, immutable

# Manifest/HTML, который может измениться
Cache-Control: no-cache
ETag: "manifest-a81f2c"

`no-cache` не означает «не хранить»: он требует validation перед reuse. `no-store` запрещает хранение и обычно избыточен для публичной картинки. `s-maxage` может задать отдельный срок shared cache. Проверьте, не перезаписывает ли CDN origin headers своей cache policy.

Cache key должен различать только реальные варианты

CDN выбирает объект по cache key. Если обработчик генерирует ширину по query `?w=640`, но CDN игнорирует query, разные варианты столкнутся. Обратная ошибка — включить в ключ случайные query-параметры и cookies: hit rate падает, а invalidation приходится делать для множества вариантов.

  • Запишите canonical path изображения и допустимые параметры resize/format.
  • Нормализуйте порядок и значения query до построения cache key.
  • Добавляйте `Vary` только по заголовкам, которые действительно меняют representation.
  • Не включайте auth cookie в публичную картинку; private media требует отдельной политики.
  • Сохраняйте Content-Type при upload: CDN не определяет его по содержимому автоматически.

Выкладка нового URL не оставляет окна с 404

  1. Сгенерировать оптимизированные варианты и fingerprint из конечных bytes.
  2. Загрузить все файлы под новыми keys с правильными Content-Type и Cache-Control.
  3. Запросить каждый ключ через CDN и проверить 200, dimensions и checksum.
  4. Атомарно обновить manifest/запись товара/HTML на новые URL.
  5. Наблюдать 404 и ошибки декодирования; при проблеме вернуть старый manifest.
  6. Удалять старые версии только после окна отката и с учётом старых страниц/писем.

CloudFront рекомендует versioned file names для частых обновлений: такой URL работает даже у пользователя с локальным или корпоративным кешем и упрощает roll forward/back. Это versioning имени, не S3 Object Versioning; последний может быть дополнительной защитой origin, но не меняет URL автоматически.

Invalidation нужна для ошибки и удаления, а не каждого релиза

Когда неправильная или чувствительная картинка уже опубликована по долгоживущему URL, создайте точечную invalidation. Учитывайте URI rewrite, query variants и регистр пути. Удаление файла только на origin недостаточно: edge может продолжать отдавать его до истечения срока. После запроса дождитесь статуса завершения и проверьте несколько edge.

СитуацияОсновной инструментОткат
обычное обновление фотоновый versioned URLвернуть ссылку на предыдущий URL
ошибочный файл уже закешированточечная invalidationзагрузить исправленный файл/новый URL
чувствительный объект надо убратьзакрыть origin + invalidationнет автоматического возврата
сломана массовая выкладкавернуть manifestстарые immutable assets остаются доступны

Для расследования сохраните точный URL, два SHA-256, response headers origin/CDN, cache-status и время публикации. Исправление считается завершённым, когда новый URL отдаёт одинаковые bytes из разных точек, HTML больше не ссылается на старую версию, а процедура следующего обновления не требует ручной очистки браузера.

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