파일을 고쳤는데 옛 파일이 계속 보일 때 캐시 다섯 곳 점검

먼저 결론
증상: 서버의 파일을 고쳤는데 옛 파일이 계속 내려오거나, 화면 숫자가 옛것으로 되돌아가거나, 링크 미리보기가 며칠씩 그대로였습니다.
원인: 캐시가 서버 한 곳이 아니라 CDN, 데이터 파일 응답, 메신저 미리보기, 휴대폰 브라우저, 파일 저장소 다섯 곳에 따로 있었습니다.
해결: 같은 이름 덮어쓰기 대신 버전별 파일 이름을 쓰고, 자주 바뀌는 파일은 no-store 로 내보내고, 확인은 바깥 주소로 합니다.

"고쳤는데 안 바뀌었다"는 말을 들으면 서버를 다시 봅니다. 그런데 서버의 파일이 이미 새것이라면, 옛것은 서버와 화면 사이 어딘가에 남아 있는 것입니다. 서로 다른 세 가지를 만들다 다섯 군데에서 이 일을 겪었고, 자리마다 처방이 달랐습니다.

워드프레스의 캐시 플러그인이나 테마 CSS 캐시 문제라면 워드프레스 CSS 수정이 화면에 안 보일 때를 먼저 보세요. 이 글은 그 바깥, 즉 CDN 과 브라우저와 저장소 쪽 이야기입니다.

옛 것이 남아 있던 다섯 자리

자리 본 증상 처방
CDN(Cloudflare) 같은 이름으로 덮은 설치 파일이 옛것으로 내려옴 버전별 파일 이름, 버전 안내 파일만 캐시 제외
데이터 파일 응답 관리 화면의 data.js 가 4시간 묵어 숫자가 되돌아감 no-store, CDN-Cache-Control, 주소에 시각 붙이기
카카오톡 링크 미리보기 페이지를 고쳐도 카드가 며칠 그대로 주소 뒤에 ?1, 처음부터 경로에 날짜와 이름
휴대폰 브라우저 깨진 옛 HTML 을 붙들고 "또 깨진다"가 반복 서버에서 Cache-Control: no-store
파일 저장소(Vercel Blob) 덮어쓴 글이 몇 초 동안 안 보여 또 누름 쓸 때마다 새 파일 이름, 화면에 먼저 보여 주기

CDN 에 남아 있던 것

같은 이름으로 덮은 설치 파일

Cloudflare 뒤에 있는 서버에 프로그램 설치 파일을 올려 두고, 새 판을 같은 파일 이름으로 덮었습니다. 서버의 파일은 새것인데 내려받으면 옛 파일이 왔습니다. 응답 헤더를 보니 설치 파일 같은 정적 파일은 Cf-Cache-Status: HIT, 즉 CDN 이 들고 있던 사본이었습니다.

해결은 이름을 바꾸는 것이었습니다. 설치 파일은 app-Setup-1.2.3.exe 처럼 판마다 다른 이름으로 올리고, "지금 최신 판은 무엇인가"를 적은 작은 안내 파일만 같은 이름을 씁니다. 그 안내 파일은 응답 헤더에 DYNAMIC 으로 찍혀 캐시되지 않았기 때문에, 올리는 즉시 새 판을 가리켰습니다.

curl -sI https://example.com/download/latest.yml | grep -i cf-cache-status
curl -sI https://example.com/download/app-Setup-1.2.3.exe | grep -i cf-cache-status

4시간 묵은 데이터 파일

관리 화면은 숫자와 확인 상태를 data.js 라는 파일로 받아 그렸습니다. 이 파일이 Cloudflare 에 4시간 캐시돼, 서버에서 확인 처리를 해도 화면은 옛 상태로 되돌아갔습니다.

응답에 브라우저용 Cache-Control: no-store 와 CDN 용 CDN-Cache-Control 을 함께 붙이고, 화면 쪽에서는 매번 data.js?v=Date.now() 처럼 시각을 붙여 불렀습니다.

Cache-Control: no-store
CDN-Cache-Control: no-store

여기서 중요한 것은 확인하는 주소입니다. localhost 나 서버 안에서 열면 CDN 을 거치지 않아 이 문제가 보이지 않습니다. 반드시 바깥에서 쓰는 실제 주소로 확인합니다.

보는 사람 쪽에 남아 있던 것

링크 미리보기 카드는 며칠을 간다

카카오톡으로 보낼 모바일 한 장 페이지를 만들 때였습니다. 링크를 한 번 보내 미리보기 카드가 만들어지자, 페이지 제목과 그림을 고쳐도 카드는 며칠씩 옛것이었습니다. 카카오톡이 미리보기를 따로 저장하기 때문입니다.

급할 때는 주소 뒤에 ?1 을 붙이면 다른 주소로 보고 카드를 새로 만듭니다. 처음부터 경로에 날짜와 이름을 넣어 두면(/page/날짜-이름 같은 모양) 이 문제를 아예 피할 수 있습니다.

휴대폰이 붙든 깨진 옛 HTML

같은 페이지를 고치는 동안 휴대폰으로 확인하면 "또 깨진다"가 반복됐습니다. 이미 고친 깨짐이었는데, 휴대폰 브라우저가 깨진 옛 HTML 을 저장해 두고 있었습니다. 브라우저에 저장된 사본은 서버를 고쳐도 남아 있습니다.

그래서 서버 쪽에서 막았습니다. Vercel 이라면 vercel.json 의 headers 에 Cache-Control: no-store 를 겁니다. 한 장짜리 가벼운 페이지라 매번 새로 받아도 손해가 거의 없었습니다.

{
  "headers": [
    { "source": "/(.*)", "headers": [ { "key": "Cache-Control", "value": "no-store" } ] }
  ]
}

저장소는 덮어쓴 직후 잠시 옛것을 준다

방문자가 글을 남기면 Vercel Blob 의 같은 파일에 덮어쓰는 구조였습니다. 그런데 덮어쓴 직후 몇 초 동안은 읽으면 옛 내용이 왔습니다. 글을 남긴 사람은 자기 글이 안 보이니 실패한 줄 알고 또 눌렀습니다.

두 가지를 함께 했습니다. 쓸 때마다 새 파일 이름으로 저장하고 읽을 때는 가장 최근 것을 읽게 했습니다. 그리고 화면에서는 방금 쓴 글을 바로 보여 준 뒤 5초 뒤에 서버 값으로 맞췄습니다. 하나만 하면 여전히 틈이 남아서 둘 다 필요했습니다.

덧붙여: 배포 제외 목록

캐시 문제는 아니지만 같은 작업에서 겪은 일입니다. 새 파일로 관리용 키 파일을 만들면서 배포 제외 목록(.vercelignore)에 넣지 않아, 배포본에서 그 파일이 그대로 내려받아졌습니다. 발견하자마자 키를 다시 발급하고, 환경변수를 바꾸고, 옛 키로 요청하면 403 이 나는지까지 확인했습니다. 새 파일을 만들면 제외 목록부터 봅니다.

확인할 때 지키는 것

  • 확인은 바깥에서 쓰는 실제 주소로 합니다. localhost 나 서버 안에서 열면 CDN 을 거치지 않습니다.
  • 자주 바뀌는 파일은 같은 이름으로 덮지 않습니다. 판마다 이름을 바꾸고, 최신 판을 가리키는 작은 파일만 캐시에서 뺍니다.
  • 응답 헤더의 Cf-Cache-Status 로 그 응답이 CDN 사본(HIT)인지, 매번 서버에서 온 것(DYNAMIC)인지 봅니다.
  • 남이 보낼 링크라면 처음부터 경로에 날짜와 이름을 넣어, 고칠 때 미리보기가 꼬이지 않게 합니다.

확인한 환경

항목 내용
CDN Cloudflare(설치 파일, 관리 화면 데이터 파일)
배포와 저장소 Vercel, Vercel Blob(모바일 한 장 페이지)
확인한 시기 2026년 7월(설치 파일, 데이터 파일), 2026년 8월(미리보기, 휴대폰, 저장소)

캐시를 의심하기 전에 확인 방법이 맞는지부터 보는 순서는 curl 로 라이브 반영을 확인할 때 저지른 세 가지 실수에 정리했습니다.

이 글의 내용은 2026년 10월 12일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.