정적 파일을 같은 폴더에 둔다고 캐시 정책까지 같아지는 것은 아니었습니다. 파일명에 내용 해시가 들어가는지, 같은 주소의 내용이 바뀔 수 있는지부터 나눴습니다.

주소가 바뀌는 파일과 그대로인 파일#

공개 응답의 캐시 정책 예
대상정책전제
내용 해시가 있는 JS·CSSpublic, max-age=31536000, immutable내용이 바뀌면 URL도 바뀜
같은 주소로 갱신하는 HTMLno-cache재사용 전에 원본 서버에 확인
이름이 고정된 자산짧은 유효기간 또는 재검증배포 때 같은 URL의 내용이 바뀔 수 있음

ServeDir의 경로와 응답 헤더를 함께 보기#

Axum에서 tower-http의 ServeDir을 연결할 때 경로별로 응답 정책을 나눕니다. pkg라는 폴더 이름만으로 모든 파일이 immutable이라고 결정하지 않습니다. 빌드가 실제로 만든 파일명을 확인해야 합니다.

응답 헤더 확인 — 파일명은 실제 빌드 결과로 바꾸기
Shell
curl -I http://127.0.0.1:3000/curl -I http://127.0.0.1:3000/pkg/blog-a1b2c3.js

no-cache는 저장 금지가 아니라 재사용 전 확인입니다. 저장 자체를 막는 no-store와 구분합니다. 인증된 응답이나 개인별 HTML은 공개 정적 자산과 별도로 정책을 정합니다.

참고 자료

  1. MDN Web Docs. (2026 열람). Cache-Control