Экспериментальная ошибка конфликта пререндеринга

Тип: boolean
По умолчанию: false

Добавлено в: astro@5.14.0

Превращает предупреждения о конфликтах пререндеринга в ошибки во время процесса сборки.

В настоящее время Astro предупреждает вас во время сборки о любых конфликтах между несколькими динамическими маршрутами, которые могут привести к одному и тому же выходному пути. Например, /blog/[slug] и /blog/[...all] могут пытаться пререндерить путь /blog/post-1. В таких случаях Astro рендерит только маршрут с самым высоким приоритетом для конфликтующего пути. Это позволяет вашему сайту успешно собираться, хотя вы можете обнаружить, что некоторые страницы рендерятся неожиданными маршрутами.

При установке этого экспериментального флага сборка вместо этого немедленно завершится ошибкой. Это потребует от вас немедленного разрешения любых конфликтов маршрутизации и гарантирует, что Astro строит ваши маршруты так, как вы планируете.

Чтобы включить это поведение, добавьте флаг функции experimental.failOnPrerenderConflict в вашу конфигурацию Astro:

import { defineConfig } from "astro/config"

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

Использование

После включения этого флага вы можете столкнуться с ошибками о конфликтующих пререндеренных маршрутах при попытке собрать ваш проект. Если это произойдет, вам нужно будет обновить один или несколько ваших динамических маршрутов, чтобы избежать неоднозначной маршрутизации.