Если 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 растёт со старым hash | edge 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
- Сгенерировать оптимизированные варианты и fingerprint из конечных bytes.
- Загрузить все файлы под новыми keys с правильными Content-Type и Cache-Control.
- Запросить каждый ключ через CDN и проверить 200, dimensions и checksum.
- Атомарно обновить manifest/запись товара/HTML на новые URL.
- Наблюдать 404 и ошибки декодирования; при проблеме вернуть старый manifest.
- Удалять старые версии только после окна отката и с учётом старых страниц/писем.
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 больше не ссылается на старую версию, а процедура следующего обновления не требует ручной очистки браузера.