---
title: "📓 작업일지 — CF 불완전 전파 대책 3종(index no-cache·assets 진짜404·배포 스모크체크)"
category: "worklog"
parent: "Claude Code 작업일지"
updated: "2026-07-11"
priority: "Medium"
purpose: "Cloudflare Pages 배포 시 발생할 수 있는 '불완전 전파'(구버전 index.html이 새 asset chunk를 참조해 화이트스크린이 뜨는 문제)를 막기 위한 대책 3종을 데모 검증 후 메인에 반영한 작업 기록."
read_when: ["CF Pages 배포", "불완전 전파", "화이트스크린", "chunk 404", "no-cache", "배포 스모크체크", "verify_deploy"]
document_type: "개발일지"
source_status: "generated"
knowledge_group: "03_history"
work_timestamp: "20260711_203951"
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
context: "달록 본레포(ccy-hansbridge/dallog), 커밋 23d3fd4."
---

# 작업일지 — CF 불완전 전파 대책 3종

> 배포 직후 사용자 화면이 CDN 캐시 때문에 옛날 페이지와 새 파일이 뒤섞여 접속되면서 하얗게 뜨는(화이트스크린) 사고가 있을 수 있다. 이를 막기 위한 세 가지 안전장치를 추가했다.

## 1. 무엇을 했나

1. **index no-cache**: `public/_headers`에 규칙을 추가해 `index.html`이 캐시되지 않도록 설정.
2. **assets 진짜 404**: 누락된 asset 요청 시 진짜 404 + no-store 응답이 오도록 `public/assets/404.html` 추가.
3. **배포 스모크체크 스크립트**: `scripts/verify_deploy.cjs` 신규 작성 — asset 전수 확인, index Cache-Control 확인, 누락 asset 404+no-store 확인을 자동화.

## 2. 검증

- 데모에서 asset 전수 PASS, index `Cache-Control: no-cache` 확인, 누락 asset 404+no-store 확인(관련 커밋 `b403747`)을 거친 뒤 메인에 반영.

## 3. 주요 변경 파일

| 파일 | 내용 |
|---|---|
| `public/_headers` | index no-cache 규칙 추가 (+9줄) |
| `public/assets/404.html` | 누락 asset 진짜 404 응답용 신규 (+6줄) |
| `scripts/verify_deploy.cjs` | 배포 스모크체크 자동화 스크립트 신규 (+22줄) |

## 4. 관련 커밋

- `23d3fd4` fix(deploy): CF 불완전 전파 대책 3종 — index no-cache·assets 진짜404·배포 스모크체크 (demo 검증 통과분) (2026-07-11)

## 5. 남은 이슈

- 커밋 메시지 기준으로 별도 남은 이슈 언급 없음.