حل مشکل تداخل مسیرها در FastAPI؛ بررسی قابلیت جدید app.frontend

بررسی متد جدید app.frontend در FastAPI نسخه 0.138 برای مدیریت هوشمند تداخل مسیرهای SPA و API و بهبود اولویت‌بندی درخواست‌ها.

توسعه‌دهندگانی که با فریم‌ورک FastAPI کار می‌کنند، هنگام سرو کردن اپلیکیشن‌های تک‌صفحه‌ای (SPA) مانند پروژه‌های ری‌اکت یا ویو، همواره با چالش ترتیب تعریف مسیرها (Routes) روبرو بوده‌اند. در نسخه‌های پیشین، اگر مسیر کلی (Catch-all) را پیش از مسیرهای API تعریف می‌کردید، درخواست‌های مربوط به داده با پاسخ‌های مربوط به رابط کاربری تداخل پیدا می‌کرد. فریم‌ورک FastAPI در نسخه ۰.۱۳۸ با معرفی متد ۰ این گره فنی را باز کرده است.

ریشه مشکل در معماری سنتی SPA

در اپلیکیشن‌های مدرن، معمولاً یک فایل ۱ مسئولیت نمایش تمام صفحات را بر عهده دارد. برای اینکه کاربر با رفرش کردن صفحه در آدرسی مثل ۲ با خطای ۴۰۴ مواجه نشود، برنامه‌نویسان مجبور بودند یک مسیر کلی تعریف کنند که هر درخواستی را به سمت فایل اصلی هدایت کند.

مشکل زمانی رخ می‌داد که این مسیر کلی، ناخواسته درخواست‌های API را هم شکار می‌کرد. برای مثال، اگر مسیر ۳ را طوری تنظیم می‌کردید که فایل ایندکس را برگرداند و تصادفاً این کد را بالاتر از مسیر ۴ می‌نوشتید، کلاینت به‌جای لیست کاربران، کد HTML صفحه اول را دریافت می‌کرد. این موضوع باعث می‌شد توسعه‌دهنده همیشه نگران چیدمان خطوط کد باشد.

راهکار جدید FastAPI چگونه کار می‌کند؟

قابلیت ۵ به جای تکیه بر ترتیب نوشتن کد، منطق مدیریت مسیرها را تغییر می‌دهد. این متد به فریم‌ورک می‌فهماند که بخش فرانت‌اند باید پایین‌ترین اولویت را داشته باشد. به این ترتیب، FastAPI ابتدا تلاش می‌کند درخواست را با مسیرهای API یا فایل‌های استاتیک موجود در پوشه ۶ تطبیق دهد. تنها در صورتی که هیچ مسیری پیدا نشود، کنترل را به بخش فرانت‌اند می‌سپارد تا فایل اصلی SPA را نمایش دهد.

مقایسه عملکرد و سرعت

در آزمایش‌های فنی انجام شده روی نسخه ۰.۱۳۸، عملکرد سه روش مختلف برای سرو کردن SPA بررسی شد:

۱. روش دستی قدیمی: استفاده از مسیرهای Catch-all که در صورت اشتباه در ترتیب، منجر به بازگشت وضعیت ۲۰۰ با بدنه اشتباه می‌شد. ۲. استفاده از استثنای ۴۰۴: هدایت کاربر به فرانت‌اند در صورت بروز خطای یافت نشد. ۳. متد جدید app.frontend: روش استاندارد و داخلی FastAPI.

نتایج نشان می‌دهد که هر سه روش قدرتی در حدود ۴۴۰ درخواست در ثانیه را پشتیبانی می‌کنند. این یعنی استفاده از قابلیت جدید، هیچ هزینه‌ای از نظر بار پردازشی به سرور تحمیل نمی‌کند و صرفاً امنیت و دقت کدنویسی را بالا می‌برد.

کاربرد واقعی در پروژه‌های هوش مصنوعی

فرض کنید در حال توسعه یک دستیار هوشمند با استفاده از زیرساخت‌های هوش مصنوعی نهال هستید. شما یک پنل مدیریتی دارید که با ری‌اکت ساخته شده و همزمان از ایجنت‌های هوش مصنوعی برای پردازش داده‌ها استفاده می‌کنید. پیش از این، اگر مسیرهای پنل را به درستی اولویت‌بندی نمی‌کردید، ممکن بود درخواست‌های ارسالی به مدل‌های بین‌المللی با صفحه لودینگ فرانت‌اند جایگزین شوند. با ۷، ایجنت‌های شما بدون تداخل با رابط کاربری، داده‌ها را دریافت و ارسال می‌کنند.

چرا باید به این نسخه مهاجرت کرد؟

اصلی‌ترین دلیل، حذف خطاهای انسانی است. در پروژه‌های بزرگ سازمانی که تعداد مسیرها از صدها مورد می‌گذرد، مدیریت دستی ترتیب آن‌ها عملاً غیرممکن است. این قابلیت اجازه می‌دهد بخش فرانت‌اند و بک‌ئند به صورت مستقل و بدون ترس از شکستن مسیرهای یکدیگر توسعه یابند.

محدودیت‌ها و پیش‌نیازها

برای استفاده از این ویژگی، باید پکیج ۸ خود را به نسخه ۰.۱۳۸ یا بالاتر ارتقا دهید. همچنین در نظر داشته باشید که این متد برای ساختارهای هیبریدی طراحی شده است؛ یعنی جایی که فایل‌های فرانت‌اند توسط همان سرور پایتونی سرو می‌شوند. اگر فرانت‌اند شما روی سرویس‌های مجزایی مثل ورسل یا کلاودفلر میزبانی می‌شود، همچنان نیازی به تغییر در سمت FastAPI نخواهید داشت.

این به‌روزرسانی نشان‌دهنده حرکت FastAPI به سمت بلوغ بیشتر در مدیریت تجربه‌ی یکپارچه توسعه‌دهنده است. شفافیت در اولویت‌بندی مسیرها، دقیقاً همان چیزی است که برای ساخت ابزارهای پیچیده و دستیارهای هوشمند در بستر فارسی به آن نیاز داریم.

منبع: dev.to