מרוצי תהליכים בעולם השרתים מתגלים תמיד ברגע הכי פחות נוח, בדרך כלל כשוובהוק כפול מספק סליקה מחייב לקוח פעמיים על אותה עגלת קניות בדיוק. עד עכשיו, מי שהריץ משימות רקע רגישות בעזרת הכלים של Vercel נאלץ לבצע בדיקה מוקדמת ואז להזניק תהליך, או להקים שרת Redis חיצוני רק כדי לייצר מנעול אטומי. אתמול, 4 בנובמבר 2026, שחררה החברה את גרסה 5.4.0 של Workflow SDK שמבטיחה לפתור את הפלונטר הזה ישירות מתוך הקוד שלכם.
אם אתם כותבים שירותי רקע ביישומי Next.js, זה עדכון מעשי שמייתר ספריות חיצוניות.
סוף למרוץ בין הבדיקה להרצה
הבעיה השורשית בגרסאות הקודמות נבעה מפער זמנים מובנה. הדפוס המקובל דרש לקרוא לפונקציית הבדיקה getHookByToken, לבדוק אם קיים תהליך פעיל, ורק אז להפעיל את פונקציית start. במילי-שניות שחלפו בין הבדיקה להרצה בפועל, בקשה מקבילה נוספת הצליחה לעבור את המחסום ולייצר ריצה כפולה. בגרסה 5.4.0 הפעולה הזו אוחדה. הקריאה ל-start מקבלת כעת פרמטר בשם experimental_hook עם מפתח ייחודי (token), ומבצעת את הבדיקה והנעילה בפעולה אטומית אחת בלבד.
הפונקציה start של Workflow SDK יכולה כעת לקבל ריצה ולתפוס הוק בצעד אטומי אחד. הפעלות כפולות של תהליכי עבודה נכשלות בצורה בטוחה.הדוקומנטציה הרשמית של Vercel
ההתנהגות הזו מוסברת בהרחבה במסמכי idempotency documentation של הפרויקט.
ברגע שריצה ראשונה תופסת את הטוקן, כל קריאה מקבילה שמשתמשת באותו מזהה נחסמת באופן מיידי וזורקת שגיאה מסוג HookConflictError. השגיאה מחזירה ישירות את המזהה של הריצה המקורית, בלי לייצר תהליך נוסף ברקע.
כשהודעות מקדימות את התהליך
אחד האתגרים הנפוצים בתהליכים מבוזרים מתרחש כשמערכת חיצונית שולחת עדכון מהר מדי, עוד לפני שתשתית השרת הספיקה להתחיל את הריצה. המנגנון החדש פותר את זה באמצעות resumeHook. מכיוון שההוק נתפס רשמית כבר בשלב הזימון האטומי של start, הפיילודים המוקדמים נקלטים בחוצץ ייעודי וממתינים בתור מסודר.
כשהקוד של התהליך מגיע לשלב שבו הוא פותח את createHook עם אותו טוקן בדיוק, הוא מתחבר ישירות להוק הקיים. אין כאן רישום של מנגנון חדש, אין יצירת צעדים מיותרים בתוך המערכת, וההודעות שהצטברו בחוצץ נמסרות לפי הסדר. בדוקומנטציה מדגישים כי אם התהליך שלכם אינו זקוק להודעות המשך ומנצל את הטוקן רק לצורך אידמפוטנטיות, אתם פשוט לא פותחים את ההוק, והריצה מסתיימת כסדרה.
הטוקן משתחרר מהר מדי
האותיות הקטנות של העדכון הזה הן המקום שבו מפתחים עלולים ליפול. ברירת המחדל של המערכת היא לשחרר את הטוקן ברגע שריצת ה-Workflow מסתיימת. אם שירות תשלומים חיצוני שולח ניסיון חוזר דקה לאחר שההזמנה טופלה והסתיימה, המערכת תתייחס אליו כבקשה חדשה, תתפוס את הטוקן מחדש ותבצע שוב את התהליך. כדי למנוע ריצות כפולות מניסיונות חוזרים מאוחרים, חובה להגדיר ידנית את הפרמטר experimental_minRetention בעת ההפעלה.
ההגדרה הזו שומרת על הטוקן כחסום לפרק זמן מוגדר מראש מרגע ההזנקה, גם אחרי שהריצה נסגרה בהצלחה. יש כאן גם שאלות שנותרו פתוחות: Vercel לא מפרטת מהי תשתית האחסון שמנהלת את הנעילה מאחורי הקלעים, ומה קורה במקרה של פסק זמן. כמו כן, לא ברור אם קריאות שנחסמות ונכשלות עם שגיאת קונפליקט עדיין מחויבות בעלויות ריצה רגילות של פונקציות ענן.
מבחינת תשתיות מקומיות, ל-Vercel אין שרתי Edge בישראל, כך שכל התקשורת של מנוע התהליכים מנוהלת מול חוות שרתים באירופה עם זמני השהיית רשת רגילים ותמחור בדולרים בלבד.
הצעד הבא בקוד שלכם
כדי להשתמש ביכולת הזו, עליכם לעבור לגרסה 5.4.0 של ספרית workflow. הטיפול בקוד פשוט למדי: עוטפים את קריאת ה-start בבלוק try/catch, בודקים באמצעות HookConflictError.is אם מדובר בכפילות, ומנתבים את המידע לריצה הקיימת בעזרת resumeHook.
לא הייתי ממהר להעביר מערכות קריטיות לשיטה החדשה בלי לבדוק היטב את זמני ה-retention. היכולת כולה עדיין נושאת את הקידומת experimental, מה שאומר שממשק הפונקציות עלול להשתנות בעדכונים הבאים. בינתיים, אם יש לכם שרת Redis שמבצע נעילות אמינות בייצור, הוא יכול להישאר דולק עוד קצת.
מקורות
- Workflow SDK adds idempotent startshttps://vercel.com/changelog/atomic-start-hooks-in-the-workflow-sdk
- idempotency documentationhttps://useworkflow.dev/docs/foundations/idempotency
- Vercelhttps://weba.co.il/tools/vercel/
הידיעה נכתבה מהמקורות שלמעלה בתאריך הפרסום, וכל טענה בה נבדקה מולם. מצאתם טעות? כתבו.