یک کتابخانهی کلاینت متدی به نام cancel(request) دارد که رفتارش روی stdio و پروتکل HTTP جریانی (Streamable HTTP) کاملاً یکسان است: اعلان notifications/cancelled را همراه با شناسهی درخواست مینویسد یا POST میکند. در بستر HTTP، سرورها به اجرای کار ادامه میدهند و گاهی حتی پس از لغو نیز پاسخ میفرستند. متد دومی هم به نام cancelTask وجود دارد که وضعیت موفقیتآمیز برمیگرداند؛ رابط کاربری وضعیت را «متوقفشده» نشان میدهد، ولی ورکر همچنان به کارش ادامه میدهد. ایراد هر دو متد چیست؟
اول خودتان جواب بدهید، بعد پاسخ را باز کنید.
پاسخ کوتاه
لغو درخواست وابسته به بستر انتقال (transport) است و وظیفهی پایدار (durable task) سازوکار کاملاً متفاوتی دارد. در stdio، کلاینت اعلان notifications/cancelled را همراه با شناسهی درخواست میفرستد و هیچ پاسخی دریافت نمیکند. در پروتکل HTTP جریانی، سیگنالِ لغو همان بستن استریم پاسخ مربوط به آن درخواست است و POST کردن اعلان لغو، سیگنال اشتباهی است. متد tasks/cancel تنها نیت (intent) لغو را برای یک وظیفهی پایدار تأیید میکند؛ وظیفهای که ممکن است تا زمان رسیدن ورکر به یک چکپوینت و بررسی فلگ لغو، همچنان در وضعیت working بماند. بنابراین رابط کاربری باید تا رسیدن وظیفه به وضعیت نهایی، آن را پولینگ (poll) کند.
پاسخ کامل
سه سازوکار
| سازوکار | هدف | سیگنال | معنای موفقیت |
|---|---|---|---|
| لغو درخواست روی stdio | یک RPC در حال اجرا | notifications/cancelled |
کلاینت از درخواست منصرف شده است؛ سرور در صورت امکان باید کار را متوقف کند |
| لغو درخواست روی HTTP | یک استریم پاسخ در حال اجرا | بستن استریم | همانند مورد قبل |
tasks/cancel |
یک وظیفهی پایدار | یک درخواست معمولی MCP | سرور نیت لغو را تأیید کرده است |
نیت لغو در هر دو بستر انتقال یکسان است: کلاینت دیگر به نتیجه نیازی ندارد. تفاوت سیگنال روی شبکه به این دلیل است که stdio از یک کانال مشترک برای همه چیز استفاده میکند، در حالی که هر درخواست HTTP استریم پاسخ یا استریم SSE اختصاصی خودش را دارد.
لغو یک مسابقهی همزمانی است
هر دو ترتیب زیر معتبرند: اگر لغو زودتر برسد، سرور درخواست را لغوشده علامت میزند و پس از اتمام کار ورکر، از ارسال پاسخ جلوگیری میکند. اگر ورکر زودتر عملیات را commit کند، سرور پاسخ را میفرستد و اعلان دیرهنگام را نادیده میگیرد؛ کلاینت نیز پاسخِ دیررسیدهی درخواستی را که رها کرده است نادیده میگیرد. هیچکدام از دو طرف نمیتوانند اثبات کنند که طرف مقابل کدام رویداد را زودتر دیده است. اعلانهای لغو با ساختار نادرست، شناسهی ناشناخته و ازپیشتکمیلشده نادیده گرفته میشوند؛ چرا که تبدیل این مسابقههای همزمانی (race conditions) به خطا، مسابقههای بیشتری میسازد.
سرور مجاز به ارسال چه پیامهایی است؟
سرور برای لغو فراخوانیهای دلخواه کلاینت از notifications/cancelled استفاده نمیکند. روی stdio، لغوِ ارسالی از سمت سرور فقط برای خاتمه دادن به درخواست subscriptions/listen رزرو شده است. اعلانهای پیشرفت کار باید افزایشی باشند و پس از اتمام یا لغو متوقف شوند.
چرا عمر وظیفه بیشتر از اتصال است؟
علت ایجاد یک وظیفه (Task) این است که چرخهی حیات آن فراتر از یک درخواست و یک اتصال است. با بسته شدن اتصال HTTP وضعیت وظیفه را پاک نکنید و نتیجهی tasks/cancel را اثباتِ متوقف شدن ورکر ندانید. وضعیت وظیفه را تا رسیدن به وضعیت نهایی پولینگ کنید.
دو مهلت زمانی، نه یکی
لغو اغلب ناشی از اتمام مهلت زمانی است. از دو نوع مهلت زمانی استفاده کنید: یک مهلت بیعملی (idle timeout) که پیشرفت کار میتواند آن را ریست کند، و یک مهلت حداکثری (maximum timeout) از ابتدای درخواست که هیچچیز آن را ریست نمیکند. ارسال کامنت keepalive روی استریم، پیشرفت کار به حساب نمیآید.
سؤالهای تکمیلی مصاحبهگر
- سطح 2: سرور درخواستی برای لغو دریافت میکند که کارش قبلاً تمام شده است. آیا خطا برمیگرداند؟ پاسخ مورد انتظار: خیر، اعلان را نادیده میگیرد؛ اعلان در هر صورت پاسخی دریافت نمیکند.
- سطح 3: ورکر دقیقاً پیش از رسیدن لغو به سرور، تغییری را commit میکند. هر طرف چه میکند؟ پاسخ مورد انتظار: سرور پاسخ را فرستاده است و اعلان دیرهنگام را نادیده میگیرد؛ کلاینت پاسخ دیرهنگام را نادیده میگیرد و قرارداد همپایانی (idempotency contract) تعیین میکند که آیا تلاش مجدد امن است یا خیر.
- سطح 3: سرور چه زمانی خودش میتواند
notifications/cancelledبفرستد؟ پاسخ مورد انتظار: فقط روی stdio و صرفاً برای خاتمه دادن به درخواستsubscriptions/listen؛ هرگز برای فراخوانیهای عادی کلاینت استفاده نمیشود. - سطح 4: استریم
subscriptions/listenدر میانهی اجرای وظیفه قطع میشود. آیا وضعیت وظیفهی پشت آن تغییر میکند؟ پاسخ مورد انتظار: خیر؛ کلاینت یک درخواست شنود جدید با شناسهی جدید باز میکند و وظیفه را واکشی مجدد (refetch) میکند؛ وضعیت پایدار با قطع استریم دستنخورده باقی میماند.
جوابهای اشتباهی که مصاحبهگرها زیاد میشنوند
- «برای حفظ تقارن، روی HTTP هم
notifications/cancelledرا POST کنید.» هر درخواست HTTP صاحب استریم پاسخ خود است و بستن آن، همان سیگنالی است که با طول عمر درخواست همخوانی دارد. - «موفقیتآمیز بودن
tasks/cancelیعنی ورکر متوقف شده است.» این متد فقط دریافت درخواست را تأیید میکند. وظیفه میتواند تا رسیدن به یک چکپوینت در وضعیتworkingبماند، یا اینکه کار زودتر تمام شود. - «برای لغو یک شناسهی درخواست ناشناخته، خطا برگردانید.» لغوهای ناشناخته، با ساختار نادرست و قبلاً تکمیلشده بر اساس طراحی نادیده گرفته میشوند.
کجای دوره آموزش داده میشود
در درس پایداری و قابلیت اطمینان، این سه سازوکار و هر دو حالت مسابقهی همزمانی بررسی شدهاند.