[HTTP] Cache-Control 헤더

TL;DR

---

Cache-Control은 브라우저와 중간 서버(Proxy, CDN 등)가 어떤 방식으로 응답을 캐싱할지 지정하는 헤더로, 캐싱 가능 여부(public, private, no-store), 캐시 유효 기간(max-age), 재검증 방식(no-cache, must-revalidate) 등을 설정할 수 있다.

 

 

정적인 리소스

---

잘 변하지 않는 정적인 리소스는 장기간 캐시
Cache-Control: public, max-age=31536000, immutable

 

• public: 브라우저와 중간 서버(프록시, CDN 등) 모두 응답을 캐싱하고 재사용할 수 있도록 허용
• max-age=31536000: 캐시 생성 후 1년(31,536,000초) 동안 fresh 상태 유지
• immutable: 유효 기간 내 리소스가 변경되지 않음을 나타내며, 해당 기간 동안 브라우저가 재검증 요청을 보내지 않도록 지시.

 

 

동적인 리소스

---

동적인 리소스는 항상 최신 상태를 유지할 수 있도록 매번 서버에 재검증
Cache-Control: no-cache, must-revalidate

 

• no-cache: 캐시 데이터 사용 전 매번 원본 서버에 재검증
• must-revalidate: 만료된 캐시 데이터는 원본 서버 재검증 없이 사용 불가

 

 

기타 Cache-Control 지시어

---

💡 fresh는 캐시 된 응답이 아직 만료되지 않아 유효한 상태를 나타내고, stale은 캐시 된 응답이 만료되어 최신 상태가 아님을 나타냄. stale-while-revalidate 지시어 사용 시 stale 캐시가 재사용될 수 있음.

 

• private: 응답을 사용자(브라우저 등) 캐시에만 저장하고, 중간 서버(CDN 등)에는 저장하지 않도록 지시
• no-store: 브라우저와 중간 서버 모두 응답을 저장하지 않도록 지시(민감한 정보 처리에 적합)
• stale-while-revalidate: 만료된 캐시를 임시로 제공하고, 백그라운드에서 재검증/캐시 업데이트 수행
• max-stale: 클라이언트가 만료된 응답을 허용하는 시간. 예를 들어 클라이언트에서 max-stale=60 으로 요청하면 캐시 된 응답이 만료된 후 최대 60초까지는 허용한다는 것을 나타냄. 값 없이 max-stale만 사용하면 만료된 응답도 시간제한 없이 받아들인다는 의미
• min-fresh: 클라이언트가 받는 응답이 지정 시간 동안 fresh 하도록 요구. 예를 들어 min-fresh=30 으로 요청하면 최소 30초 동안 fresh 상태로 유지할 수 있는 응답만 받겠다는 의미

 

 

재검증 요청 헤더

---

• If-None-Match: 제공한 ETag와 서버 리소스의 ETag 값이 다를 때만 요청 처리
• If-Modified-Since: 지정한 날짜 이후 리소스가 수정되었을 때만 요청 처리
• If-Match: ETag가 일치할 때만 요청 처리
• If-Unmodified-Since: 지정한 날짜 이후 리소스가 수정되지 않았을 때만 요청 처리
• If-Range: 리소스가 변경되지 않았으면 부분 전송, 변경되었으면 전체 전송

 

 

레퍼런스

---

Cache-Control - HTTP | MDN