[HTTP] Cache-Control 헤더

Cache-Control 헤더: 클라이언트와 중간 서버(Proxy, CDN 등)가 어떤 방식으로 응답을 캐싱할지 지정하는 헤더(특정 응답을 얼마동안, 어떻게 캐싱할지 지정).

 

정적인 리소스

---

잘 변하지 않는 정적인 리소스는 장기간 캐시
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 상태로 유지할 수 있는 응답만 받겠다는 의미.