피드로 돌아가기
Dev.toDevOps
원문 읽기
Query Fingerprint 도입을 통한 Static Asset Cache Busting 구현
A crude workaround for fixing stale static asset caching
AI 요약
Context
Nginx Reverse Proxy Caching 적용 후 배포 시점에도 클라이언트가 구버전 파일을 참조하는 Stale Cache 문제 발생. 캐시 무효화 메커니즘 부재로 인한 사용자 경험 저하 해결 필요.
Technical Solution
- CI 단계에서 매 빌드마다 고유한 BUILD_FINGERPRINT 값 생성
- Nginx 설정 내 asset_version 변수를 생성된 Fingerprint 값으로 동적 치환
- Frontend 리소스 요청 경로에 Query String 형태의 Fingerprint를 추가하여 URL 고유성 확보
- URL 변경을 통해 CDN Edge Node 및 브라우저 캐시를 강제로 무효화하는 Cache Busting 전략 채택
실천 포인트
1. 정적 자산 배포 시 파일명 혹은 쿼리 파라미터에 버전 식별자 포함 여부 확인
2. CI/CD 파이프라인 내 빌드 고유 ID 생성 및 환경 변수 주입 프로세스 구축
3. CDN 및 Reverse Proxy의 캐시 정책과 연동된 무효화 전략 수립