React build release

정적 호스팅 배포 전 점검

정적 호스팅은 dist 폴더를 올리는 순간보다, 같은 커밋의 HTML·해시 asset·fallback 규칙이 CDN과 브라우저에서 함께 맞물리는지가 중요합니다.

릴리스가 통과해야 하는 책임 경계

Git push부터 브라우저 직접 진입까지 끊어 보며 실패 지점을 추적합니다.

one commit, one release

Git branch와 build command가 같은 commit의 dist를 만드는지 확인합니다.

publish directory, base path, rewrite rule이 산출물 경로와 맞는지 봅니다.

배포 URL과 하위 라우트 새로고침이 같은 index.html과 해시 asset을 받습니다.

증상만 보지 말고 어느 경계의 계약이 깨졌는지 같이 기록합니다.

deep link

하위 경로 새로고침이 404면 fallback 규칙 문제 /products/1 같은 클라이언트 라우트를 서버가 실제 파일로 찾고 있습니다.

합격 증거 status 200, body는 index.html

asset cache

흰 화면이나 chunk 404는 캐시와 파일 보존 문제 새 HTML이 이전 JS를 가리키거나, 이전 해시 파일이 너무 빨리 사라졌을 수 있습니다.

합격 증거 HTML no-cache, asset immutable

publish dir

Netlify publish 경로가 틀리면 이전 빌드가 살아남음 build command는 성공해도 배포된 폴더가 dist가 아니면 화면은 바뀌지 않습니다.

합격 증거 deploy log의 directory 확인