증상
배포 번들의 진입 파일(index.html)을 새것으로 교체하고 출시했는데, 옛 이름·옛 아이콘이 뜨고 CDN이 접근 거부를 낸다. 새 화면은 보이지도 않는다.
원인
번들 내부의 셸 부트스트랩에 정체성이 하드코딩돼 있었다.
name ← 셸이 이 이름으로 자기 자산 경로를 찾는다 → 접근 거부
deploymentId ← 이 값으로 화면을 소환한다. 안 바꾸면 구버전이 계속 뜬다
브랜드 표시명 / 색상 / 아이콘 ← 헤더에 옛 정체성이 노출된다표면 파일만 교체한 번들은 출시돼도 새 화면이 안 보일 수 있다. 코드는 들어갔는데 배선이 없는 상태다.
★ "파일을 갈았다"와 "그 파일이 실제로 소환된다"는 다르다.
템플릿·도너 번들을 이식할 때는 내부 부트스트랩이 참조하는 식별자를 전수로 찾아 치환한다. 무결성 메타데이터(크기·해시)가 있으면 그것도 재계산해야 한다.
미해결로 남긴 것
deploymentId를 플랫폼이 등록 시점에 재발급한다면 이 처방으로도 안 될 수 있다. 다음 검수를 리트머스로 잡고, 실패하면 이식을 접고 공식 빌드체인으로 전환하기로 했다. — 처방에 확신이 없으면 판정 기준과 철수 조건을 미리 적어둔다.