정적 구현 guide
Asset Prefix 라우팅
원본 프로젝트가 생성한 hash 기반 Next.js JavaScript와 CSS를 HTML과 같은 공개 prefix 및 호스트를 통해 제공합니다.
최종 수정일 2026-08-23
문서 rewrite만으로 부족한 이유
HTML 요청이 성공해도 script와 style이 gateway가 전달하지 않는 경로를 가리키면 화면은 깨집니다. Next.js는 build artifact를 _next static directory에 생성합니다. Asset prefix를 사용하면 생성된 문서가 public prefix 아래의 asset을 참조하므로 브라우저의 모든 resource 요청이 gateway hostname에 유지됩니다.
Content route와 asset이 동일한 prefix를 공유하면 하나의 external rewrite로 guide 문서와 hash asset을 origin에 전달할 수 있습니다. Origin은 prefixed _next route를 실제 build output으로 연결하는 내부 rewrite를 제공하며, global base path를 사용하지 않으므로 origin robots 파일은 host root에 유지됩니다.
생성된 asset을 end-to-end로 검증하기
Origin을 먼저 build하고 gateway를 통해 생성된 guide를 가져온 다음 raw HTML에서 script와 stylesheet URL을 추출합니다. 참조된 모든 prefixed asset은 gateway를 통해 200을 반환해야 합니다. Network에서는 document, JavaScript와 CSS가 public host를 사용하고 origin hostname으로 직접 요청하지 않아야 합니다.
Hash static asset은 내용이 바뀌면 URL도 바뀌므로 HTML보다 긴 gateway TTL을 사용할 수 있습니다. Public directory 파일에는 assetPrefix가 자동 적용되지 않으므로 이 테스트는 routing 결과를 흐릴 수 있는 unprefixed media 대신 CSS와 inline 표현을 사용합니다.