Устранение неполадок

Маршруты не отображаются

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

Динамическая страница не открывается

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

Превью пустое или постоянно загружается

• Проверьте консоль приложения и сетевые запросы.
• Убедитесь, что страница отображается в текущей сессии браузера.
• Дождитесь необходимых шрифтов и изображений.
• Для долгой асинхронной работы вызовите window.__UNPLUGIN_PAGEFLOW_READY__?.(), когда страница готова.

Навигация отсутствует

PageFlow находит поддерживаемые ссылки и литеральные цели. Вычисляемые программные цели могут появиться только после взаимодействия. Внутреннее устройство Astro islands намеренно не анализируется; при необходимости используйте якорь того же источника или data-pageflow-to.

Миниатюры устарели

Дайте очереди снимков обновить видимые страницы. Если кэш больше не нужен, остановите сервер разработки и удалите .unplugin-pageflow/cache.

Появляются страницы аутентификации

Аутентификация берётся из текущей сессии браузера. Войдите в локальное приложение в той же сессии или считайте ожидаемую страницу входа/отказа в доступе правильным превью.

Тесты не связываются

Проверьте правила автоматической связи и добавьте явное сопоставление pageTests. Тест запускается только при настроенной записи testCommands для его типа.

Ошибка sidecar Next.js

Убедитесь, что приложение запущено, хост и порт sidecar доступны, а обе поверхности используют ожидаемую конфигурацию одного источника. Смотрите руководство Next.js.