WEBA

הפתרון של Vercel למרוצי תהליכים דורש הגדרה אחת כדי לעבוד

גרסה 5.4.0 של Workflow SDK סוגרת את פער הכפילויות בעזרת מזהה אטומי, אבל אם לא תגדירו זמן שימור ידני החורים יחזרו בריטריי הבא.

528 מילים18 עובדות אומתו

מרוצי תהליכים בעולם השרתים מתגלים תמיד ברגע הכי פחות נוח, בדרך כלל כשוובהוק כפול מספק סליקה מחייב לקוח פעמיים על אותה עגלת קניות בדיוק. עד עכשיו, מי שהריץ משימות רקע רגישות בעזרת הכלים של 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 שמבצע נעילות אמינות בייצור, הוא יכול להישאר דולק עוד קצת.

מה לעשות עכשיושדרגו לגרסה 5.4.0 והגדירו תמיד את experimental_minRetention כדי שניסיונות חוזרים לא יפעילו תהליכים שכבר הסתיימו.

מקורות

הידיעה נכתבה מהמקורות שלמעלה בתאריך הפרסום, וכל טענה בה נבדקה מולם. מצאתם טעות? כתבו.

מה שואלים על זה

איך Workflow SDK מונע מרוצי תהליכים כפולים?

פונקציית start מבצעת נעילה ובדיקה בפעולה אטומית יחידה מול הטוקן שנמסר, כך שקריאות מקבילות מקבלות מיד שגיאת HookConflictError במקום לייצר ריצה שנייה.

מה קורה אם וובהוק חיצוני מגיע לפני שהתהליך התחיל לעבוד בפועל?

הפיילוד נשמר בחוצץ פנימי דרך resumeHook ומועבר לתהליך לפי הסדר המקורי ברגע שהוא קורא ל-createHook עם אותו טוקן.

למה התהליך עדיין עלול לרוץ פעמיים אם לא נגדיר experimental_minRetention?

ברירת המחדל של המערכת היא לשחרר את הטוקן מיד עם סיום הריצה. אם וובהוק ישלח ניסיון חוזר לאחר שהריצה נסגרה, המערכת תתייחס אליו כבקשה חדשה לחלוטין אלא אם הוגדר זמן שימור ידני.