실험적 사전 렌더링 충돌 오류

타입: boolean
기본값: false

추가된 버전: astro@5.14.0 새로운 기능

빌드 과정에서 사전 렌더링 충돌 경고를 오류로 전환합니다.

Astro는 빌드 과정에서 동일한 출력 경로를 생성할 수 있는 여러 동적 라우트 간 충돌에 대해 경고합니다. 예를 들어 /blog/[slug]와 /blog/[...all] 모두 /blog/post-1 경로를 사전 렌더링하려고 시도합니다. 이러한 경우 Astro는 충돌하는 경로에 대해 가장 높은 우선순위의 라우트만 렌더링합니다. 이를 통해 사이트는 성공적으로 빌드되지만, 일부 페이지가 예상치 못한 라우트로 렌더링된다는 사실을 발견할 수 있습니다.

이 실험적 플래그가 설정되면, 빌드는 즉시 실패하며, 오류가 발생합니다. 이로 인해 라우팅 충돌을 즉시 해결해야 하며, Astro가 라우트를 의도한 대로 빌드하도록 보장합니다.

이 동작을 활성화하려면 Astro 구성에 experimental.failOnPrerenderConflict 기능 플래그를 추가하세요.

astro.config.mjs

import { defineConfig } from "astro/config"

defineConfig({
  experimental: {
    failOnPrerenderConflict: true,
  },
});

사용하기

이 플래그를 활성화한 후에는 프로젝트 빌드 시 사전 렌더링된 라우트 충돌에 대한 오류가 발생할 수 있습니다. 이 경우 모호한 라우팅을 방지하기 위해 하나 이상의 동적 라우트를 업데이트해야 합니다.