Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
런타임 로그에 캐시 이유(Cache Reason)를 표시하는 기능이 추가되어, 요청이 신선한 캐시 히트가 아닌 구체적인 재검증 사유를 확인할 수 있게 되었습니다. 이 기능을 활용하여 누락된 요청을 디버깅하고 전반적인 캐시 히트율을 개선할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기이제 런타임 로그에는 요청이 신선한 캐시 히트(fresh cache hit)가 아닌 이유, 예를 들어 시간 기반 또는 태그 기반 재검증을 설명하는 캐시 이유(Cache Reason)가 표시됩니다. 이 캐시 이유를 사용하여 누락된 요청(misses)을 디버깅하고 히트율을 개선하세요.
캐시 이유는 CDN이 캐싱할 수 있는 모든 응답, 여기에는 ISR, Partial Prerendering, 그리고 .과 같은 지시문 헤더를 설정하는 함수가 포함됩니다. 매 요청마다 동적으로 렌더링되는 응답은 캐시 이유를 갖지 않습니다.Cache-Control``stale-while-revalidate`
로그(Logs) 탭을 열고 요청을 선택하면 해당 캐시 상태와 함께 그 이유를 볼 수 있습니다. 각 상태 및 이유는 참고 자료의 항목과 연결됩니다.캐시 상태 및 이유
캐시 이유는 , , 그리고 Vercel 플러그인의 :vercel logs``vercel metricscdn-caching skill에서 사용할 수 있습니다.
`.에 대한 자세한 내용은 캐시 상태 및 이유를 참조하세요.
<table><tbody><tr><td><p>캐시 상태</p></td><td><p>가능한 이유</p></td></tr><tr><td><p>MISS</p></td><td><p>콜드(Cold), 요청 축소(Request collapsed), 오류(Error)</p></td></tr><tr><td><p>BYPASS</p></td><td><p>초안 모드(Draft Mode), 프리렌더 우회(Prerender Bypass), 크롤러(Crawler)</p></td></tr><tr><td><p>STALE</p></td><td><p>시간 기반 재검증(Time-based revalidation), 태그 기반 무효화(Tag-based invalidation), 재검증 오류(Revalidation error)</p></td></tr><tr><td><p>REVALIDATED</p></td><td><p>태그 기반 삭제(Tag-based deletion)</p></td></tr></tbody></table>