설명서Experience Cloud KCS

AEM as a Cloud Service에서 Fastly CDN 캐싱 비활성화

마지막 업데이트: 2026년 7월 13일

Fastly는 항상 AEM as a Cloud Service의 콘텐츠 전달 경로에 속하며 제거할 수 없습니다. Cache-Control 또는 Surrogate-Control 헤더가 누락되었거나, 재정의되었거나, 리소스 간에 일관되지 않게 적용되면 예기치 않은 캐싱이 발생합니다. 고객 관리 CDN을 사용하는 환경에서 잘못된 전달 헤더는 캐시 동작과 리디렉션 처리에도 영향을 줄 수 있습니다.

이 문제를 해결하려면 cache-control 헤더를 올바르게 구성하고 CDN 설정의 유효성을 검사하며 Fastly 통과 동작을 확인하십시오.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • 자체 CDN(BYOCDN) 배포 가져오기
  • Dispatcher 구성
  • cdn.yaml을(를) 사용한 CDN 구성

문제/증상

  • 캐시 무시가 필요한 경우 Fastly x-cache 헤더에서 MISS 또는 SYNTH를 표시합니다.
  • 구성된 캐시 제어 헤더에도 불구하고 특정 파일 유형을 빠르게 캐시합니다.
  • Surrogate-Control 또는 Surrogate-Key 헤더가 가장자리에 표시되지 않습니다.
  • 캐시된 조각이 재사용되므로 개인화된 컨텐츠는 일관되지 않은 동작을 표시합니다.
  • 요청이 여러 CDN 계층을 통과할 때 예기치 않은 리디렉션이 발생합니다.

원인

Fastly는 Adobe Experience Manager as a Cloud Service 게재 아키텍처의 필수 구성 요소이며 항상 요청 경로에 남아 있습니다. Cache-Control 또는 Surrogate-Control 헤더가 누락되거나, 불완전하거나, 재정의되거나, 리소스 유형 간에 일관되지 않게 적용되면 Fastly로 콘텐츠를 캐시합니다. .vtt files과(와) 같은 일부 에셋 형식에는 명시적 캐시 제어 규칙이 필요합니다. BYOCDN 배포에서 잘못된 X-Forwarded-Host 또는X-Forwarded-Proto헤더가 다른 캐시 키를 만들 수 있으므로 예기치 않은 캐싱 또는 리디렉션 동작이 발생합니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오

  1. 응답 헤더를 검토하여 Cache-Control 및 Surrogate-Control이(가) 영향을 받는 응답에 표시되는지 확인하십시오.
  2. Surrogate-Control에 Fastly 캐싱을 금지하는 max-age=0 또는 no-store와 같은 값이 포함되어 있는지 확인하십시오.
  3. Cache-Control 및 Surrogate-Control 헤더가 HTML, JSON, 에셋 및 기타 리소스 유형에서 일관되게 적용되도록 Dispatcher 가상 호스트 구성을 업데이트합니다. 필수 헤더를 상속하지 않는 리소스 유형에 대한 명시적 규칙을 추가합니다.
  4. 고객 관리 CDN이 Fastly 캐시 제어 지시문을 재정의하지 않는지 확인합니다.
  5. CDN 로그를 검토하여 고객 관리 CDN이 Fastly가 통과 모드로 작동하는 동안 캐싱을 수행하는지 확인합니다.
  6. 헤더 기반 컨트롤이 필요한 동작을 수행하지 못하는 경우 cdn.yaml에서 캐시 바이패스를 구성하십시오. Cloud Manager을 통해 업데이트된 구성을 배포하고 배포가 성공적으로 완료되는지 확인합니다.
  7. 원래 Host헤더 및X-Forwarded-Proto헤더가 CDN 체인 전체에 올바르게 전달되었는지 확인하여 다중 CDN 라우팅의 유효성을 검사합니다.
  8. 조각 캐싱 구현을 검토하고 개인화된 조각이 캐시되지 않았는지 확인하십시오.
  9. 동적 응답이 캐시할 수 없는 적절한 헤더를 반환하는지 확인합니다.
  10. 제거 워크플로우가 키 기반 무효화를 사용하는 경우 Surrogate-Key 헤더를 구성하십시오.
  11. Fastly 디버깅을 활성화하고 대리 키가 응답 헤더에 표시되는지 확인합니다.
  12. Fastly가 PASS를 반환하고, 고객 관리 CDN이 예상대로 캐시하며, 캐시 제거 작업이 올바르게 작동하는지 확인하여 최종 구성을 확인합니다.

관련 읽기

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