رفع اشکال

هیچ مسیری نمایش داده نمی‌شود

• مطمئن شوید آداپتور متناسب با روتر برنامه نصب شده است.
• بررسی کنید PageFlow در سرور توسعه اجرا می‌شود، نه پیش‌نمایش تولید.
• در تنظیمات سادهٔ Vite بدون روتر قابل بررسی، اگر یکپارچه‌سازی پشتیبانی می‌کند مسیرهای صریح بدهید.

صفحهٔ پویا باز نمی‌شود

مقادیر نمونهٔ امن را به dynamicParams اضافه کنید. الگوی مسیر را بررسی و URL ساخته‌شده را مستقیم باز کنید تا هدایت مجدد احراز هویت یا loader آشکار شود.

پیش‌نمایش خالی یا در حال بارگذاری می‌ماند

• کنسول برنامه و درخواست‌های شبکه را بررسی کنید.
• مطمئن شوید صفحه در نشست فعلی مرورگر رندر می‌شود.
• منتظر بارگذاری قلم‌ها و تصویرهای لازم بمانید.
• برای کار ناهمگام طولانی، پس از آمادگی صفحه window.__UNPLUGIN_PAGEFLOW_READY__?.() را فراخوانی کنید.

ناوبری وجود ندارد

PageFlow پیوندهای پشتیبانی‌شده و مقصدهای صریح را کشف می‌کند. مقصدهای برنامه‌نویسی محاسبه‌شده ممکن است فقط پس از تعامل ظاهر شوند. داخل islandهای Astro عمداً بررسی نمی‌شود؛ در صورت نیاز از لنگر هم‌مبدأ یا data-pageflow-to استفاده کنید.

تصاویر بندانگشتی قدیمی هستند

به صف ثبت فرصت دهید صفحه‌های قابل مشاهده را به‌روز کند. اگر حافظهٔ نهان دیگر مفید نیست، سرور توسعه را متوقف و .unplugin-pageflow/cache را حذف کنید.

صفحهٔ احراز هویت دیده می‌شود

احراز هویت از نشست فعلی مرورگر می‌آید. در همان نشست وارد برنامهٔ محلی شوید یا صفحهٔ معمول ورود/عدم دسترسی را پیش‌نمایش درست بدانید.

آزمون‌ها مرتبط نمی‌شوند

قواعد ارتباط خودکار را بررسی و سپس نگاشت صریح pageTests اضافه کنید. آزمون فقط وقتی اجرا می‌شود که نوع آن ورودی testCommands پیکربندی‌شده داشته باشد.

sidecarِ Next.js کار نمی‌کند

بررسی کنید برنامه اجرا می‌شود، میزبان و پورت sidecar آزاد هستند و هر دو سطح از تنظیم هم‌مبدأ مورد انتظار استفاده می‌کنند. راهنمای Next.js را ببینید.