Next.js 배포 후 정적 자산 404, 수정 결과를 확인하는 기준

검증할 문제

배포 후 정적 자산 404에서 유지해야 할 동작과 바뀌어야 할 결과를 나눠 적습니다. HTML과 hashed static asset이 서로 다른 배포 version에서 제공되면 오래된 HTML이 존재하지 않는 chunk를 요청할 수 있습니다.

원인과 테스트 조건

브라우저, CDN, framework, application과 DB cache를 각각 분리합니다. cache key, TTL, tag, 소유 instance와 변경 직후 허용할 stale 시간을 적어야 어디가 오래된 값을 주는지 알 수 있습니다.

조건	확인할 내용
대표 사례	자주 쓰는 조건에서 기대 결과가 나오는가
경계	값이나 동작이 바뀌는 지점이 안전한가
실패	오류가 정해진 방식으로 드러나고 중간 상태가 남지 않는가
반복	다시 실행해도 결과가 예측 가능한가

통과 기준과 안전망

수정 전 실패 사례는 사라지고 기존 정상 사례는 유지돼야 합니다. 프로덕션 빌드에서 정적·동적 route, 번들 크기, TTFB, 캐시 적중과 관리자 변경 직후 일관성을 확인한다. cold, hit, stale, mutation 직후, 여러 instance와 rolling deployment 조건에서 응답 header와 실제 값을 함께 확인합니다. 한 번의 가장 좋은 결과나 화면 한 장으로 완료를 선언하지 않습니다. 실패 입력과 기대 결과를 자동 test나 실행 가능한 점검으로 남깁니다.

공식 문서와 적용 범위

• Next.js Documentation (새 창에서 열림)

문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.