DocumentazioneExperience Cloud KCS

Disattiva il caching Fastly CDN in AEM as a Cloud Service

Ultimo aggiornamento: 13 luglio 2026

Fastly fa sempre parte del percorso di distribuzione dei contenuti in AEM as a Cloud Service e non può essere rimosso. Si verifica un caching imprevisto quando le intestazioni Cache-Control o Surrogate-Control risultano mancanti, sostituite o applicate in modo incoerente tra le risorse. Negli ambienti che utilizzano una rete CDN gestita dal cliente, l’utilizzo di intestazioni di inoltro non corrette può influire sul comportamento della cache e sulla gestione dei reindirizzamenti.

Per risolvere il problema, configura correttamente le intestazioni cache-control, convalida le impostazioni CDN e verifica il comportamento Fastly Pass-Through.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Distribuzioni CDN (BYOCDN) personalizzate
  • Configurazioni Dispatcher
  • Configurazione CDN tramite cdn.yaml

Problema/Sintomi

  • L’intestazione Fastly x-cache mostra i messaggi MANCANTI o SYNTH quando è previsto il bypass della cache.
  • Memorizza in cache tipi di file specifici nonostante le intestazioni di controllo cache configurate.
  • Le intestazioni Surrogate-Control o Surrogate-Key non vengono visualizzate nel server Edge di.
  • Il contenuto personalizzato mostra un comportamento incoerente perché i frammenti memorizzati in cache vengono riutilizzati.
  • Reindirizzamenti imprevisti si verificano quando le richieste passano attraverso più livelli CDN.

Causa

Fastly è un componente integrale dell’architettura di consegna Adobe Experience Manager as a Cloud Service e rimane sempre nel percorso della richiesta. Memorizza in cache in modo rapido il contenuto quando le intestazioni Cache-Control o Surrogate-Control sono mancanti, incomplete, ignorate o applicate in modo incoerente tra i tipi di risorse. Alcuni tipi di risorse, ad esempio .vtt files, richiedono regole esplicite di controllo della cache. Nelle distribuzioni BYOCDN, intestazioni X-Forwarded-Host o X-Forwarded-Proto non corrette possono creare chiavi di cache diverse, con conseguente caching o comportamento di reindirizzamento imprevisto.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito

  1. Esaminare le intestazioni di risposta e verificare che Cache-Control e Surrogate-Control siano visualizzati nelle risposte interessate.
  2. Verificare che Surrogate-Control contenga valori quali max-age=0 o no-store che impediscono il caching Fastly.
  3. Aggiorna la configurazione dell’host virtuale Dispatcher in modo che le intestazioni Cache-Control e Surrogate-Control vengano applicate in modo coerente in HTML, JSON, risorse e altri tipi di risorse. Aggiungi regole esplicite per i tipi di risorse che non ereditano le intestazioni richieste.
  4. Verifica che la rete CDN gestita dal cliente non sostituisca le direttive Fastly Cache-Control.
  5. Esamina i registri CDN e conferma che la rete CDN gestita dal cliente esegua la memorizzazione in cache mentre Fastly funziona in modalità pass-through.
  6. Configurare il bypass della cache in cdn.yaml se i controlli basati su intestazione non raggiungono il comportamento previsto. Distribuisci la configurazione aggiornata tramite Cloud Manager e verifica che la distribuzione sia stata completata correttamente.
  7. Convalidare il routing multi-CDN confermando che l’intestazione Hoste l’intestazione X-Forwarded-Protooriginali vengono inoltrate correttamente in tutta la catena CDN.
  8. Esamina le implementazioni di caching dei frammenti e assicurati che i frammenti personalizzati non siano memorizzati in cache.
  9. Verifica che le risposte dinamiche restituiscano le intestazioni non memorizzabili in cache appropriate.
  10. Configura le intestazioni Surrogate-Key quando i flussi di lavoro di eliminazione si basano sull’annullamento della validità basato su chiavi.
  11. Abilita il debug Fastly e verifica che le chiavi alternative siano visualizzate nelle intestazioni di risposta.
  12. Convalida la configurazione finale confermando che Fastly restituisce PASS, che la rete CDN gestita dal cliente memorizza in cache come previsto e che le operazioni di eliminazione della cache si comportano correttamente.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles