جلوگیری از اقدام تکراری و یکپارچگی داده

رویدادی که دو بار می‌رسد و اجرایی که وسط کار قطع می‌شود را عادی فرض کن: کلید ایدمپوتنسی، حذف تکرار، دفتر مرحله‌ها و آشتی‌دادن پیش از تکرار اقدام.

بعد از این درس می‌توانی

  • توضیح دهد چرا در ورک‌فلوی واقعی هر رویداد ممکن است بیش از یک بار برسد و هر اجرا ممکن است نیمه‌کاره بماند.
  • برای هر اقدام بیرونی تعیین کند ایدمپوتنت است یا نه و برایش کلید، حذف تکرار یا upsert بگذارد.
  • برای چند اقدام پشت‌سرهم دفتر مرحله‌ها بسازد که اجرای دوباره را از همان مرحله ادامه دهد.
  • برای اقدامی که کلید ندارد، پیش از تکرار، وضعیت بیرونی را آشتی دهد.

چرا این درس مهم است

سامانه فروشگاهی که برگ سبز از آن سفارش می‌گیرد، هر تغییر سفارش را با Webhook به n8n می‌فرستد و اگر پاسخ را در چند ثانیه نگیرد، دوباره می‌فرستد. ورک‌فلوی برگ سبز کند بود؛ در یک روز شلوغ برای یک سفارش سه تیکت پشتیبانی ساخته شد و مشتری سه پیامک گرفت. چند روز بعد، سرور وسط یک اجرا راه‌اندازی دوباره شد: تیکت ساخته شده بود ولی پیام مشتری نرفته بود، و اجرای دوباره دستی، تیکت دوم ساخت.

در دنیای واقعی «یک رویداد، یک اجرا، کامل» استثناست. شبکه قطع می‌شود، فرستنده دوباره می‌فرستد، زمان‌بند دو بار اجرا می‌کند، و سرور وسط کار می‌خوابد. این درس طراحی‌ای می‌سازد که این‌ها را عادی بداند و باز هم هر اقدام بیرونی دقیقاً یک بار انجام شود.

مفاهیم کلیدی

یادآوری: درخواست ایدمپوتنت و کلید ایدمپوتنسی را در دوره HTTP و دفتر پردازش را در پروژه ۴ دیدی.

  • At-least-once Delivery (تحویل دست‌کم یک‌باره): قراردادی که پیام گم نمی‌شود ولی ممکن است بیش از یک بار برسد.
  • Deduplication (حذف تکرار): کنار گذاشتن ورودی‌ای که شناسه‌اش قبلاً پردازش شده است.
  • Upsert (درج یا به‌روزرسانی): نوشتنی که اگر رکورد با همان کلید هست، به‌روزش می‌کند و اگر نیست، می‌سازد؛ پس تکرارش رکورد دوم نمی‌سازد.
  • Step Ledger (دفتر مرحله‌ها): جدولی که برای هر رویداد ثبت می‌کند کدام اقدام بیرونی انجام شده و کدام نه.
  • Reconciliation (آشتی‌دادن): بررسی وضعیت واقعی سامانه بیرونی پیش از تکرار اقدامی که معلوم نیست انجام شده یا نه.

مدل ذهنی

ورک‌فلو را مثل پیک یک شرکت حمل ببین که بسته را با شماره رهگیری می‌برد. اگر فرستنده از نگرانی دو بار تماس بگیرد، پیک شماره رهگیری را می‌بیند و بسته دوم نمی‌سازد (کلید ایدمپوتنسی). اگر پیک وسط راه برگردد، از روی برگه تحویل (دفتر مرحله‌ها) می‌بیند تا کجا رفته. و اگر مطمئن نیست بسته را تحویل داده یا نه، قبل از بردن دوباره، به گیرنده زنگ می‌زند (آشتی).

پردازش یک رویداد با تحویل تکراری و قطع اجرا: رویداد می‌رسد و فوراً پاسخ می‌گیرد؛ اگر شناسه‌اش قبلاً دیده شده کنار می‌رود؛ دفتر مرحله‌ها خوانده می‌شود؛ اگر تیکت ساخته نشده، با کلید ایدمپوتنسی ساخته و ثبت می‌شود؛ پیش از ارسال پیام وضعیت در حال ارسال ثبت می‌شود؛ اگر وضعیت در حال ارسال مانده بود، اول با فهرست پیام‌های ارسال‌شده آشتی داده می‌شود؛ پس از ارسال وضعیت انجام‌شده ثبت می‌شود.

پردازش یک رویداد با تحویل تکراری و قطع اجرا

این تشبیه کجا غلط است؟ پیک همیشه می‌تواند به گیرنده زنگ بزند. ولی بعضی سامانه‌های بیرونی راهی برای پرسیدن «آیا این را گرفتی؟» ندارند. آنجا آشتی ممکن نیست و باید آگاهانه انتخاب کنی: خطر «یک بار کم» یا «یک بار زیاد»، و این انتخاب را در سند تصمیم بنویسی.

گام‌به‌گام

گام ۱: تکرار را عادی فرض کن

سه منبع رایج تکرار:

منبعچطورنمونه
فرستنده Webhookپاسخ دیر یا خطا، دوباره می‌فرستدسامانه فروشگاه پس از timeout
تلاش دوباره خودتگره با «Retry On Fail» یا اجرای دوباره دستیارسال پس از خطای شبکه
ماشه سرکشیهمان آیتم در دو سرکشی دیده می‌شودایمیل خوانده‌نشده (پروژه ۴)

قاعده Webhook: سریع پاسخ بده و کار سنگین را بعد انجام بده. گره Webhook با حالت «Immediately» بلافاصله پاسخ می‌دهد (در آزمون ما: {"message":"Workflow was started"})src-n8n-webhook-node؛ این خطر تلاش دوباره فرستنده را کم می‌کند ولی صفر نمی‌کند.

گام ۲: هر اقدام بیرونی را بشناس

MDN درخواستی را ایدمپوتنت می‌داند که اثرش روی سرور با یک بار یا چند بار فرستادن یکسان باشد؛ GET، PUT و DELETE در تعریف HTTP ایدمپوتنت‌اند و POST نهsrc-mdn-idempotent. برای هر اقدام ورک‌فلو بپرس:

  1. خودش ایدمپوتنت است؟ (به‌روزرسانی وضعیت سفارش به «ارسال‌شده»: بله).
  2. کلید ایدمپوتنسی می‌پذیرد؟ (API تیکت برگ سبز: بله؛ کلید = شناسه رویداد).
  3. می‌شود upsert کرد؟ (ردیف Google Sheets یا جدول با ستون کلید یکتا).
  4. هیچ‌کدام؟ (ارسال پیامک یا پیام ربات، ارسال ایمیل با Gmail که در مستنداتش کلیدی ندیدیمsrc-n8n-gmail-message-ops): به دفتر مرحله‌ها و آشتی نیاز دارد.

گام ۳: دو لایه در n8n

دو فایل ورک‌فلو کنار هم‌اند: assets/n8n-events-naive.json (Webhook و ثبت تیکت، بدون هیچ کنترلی) و assets/n8n-events-idempotent.json که دو لایه دارد:

  • حذف تکرار: گره Remove Duplicates با عملیات «Remove Items Processed in Previous Executions» و «Value Is New» روی event_id؛ تاریخچه پیش‌فرض ۱۰٬۰۰۰ مقدار و دامنه پیش‌فرض همان گره استsrc-n8n-remove-duplicates.
  • کلید ایدمپوتنسی: هدر Idempotency-Key با همان شناسه رویداد در ثبت تیکت؛ اگر تاریخچه حذف تکرار پاک شد یا پر شد، این لایه جلوی تیکت دوم را می‌گیرد.

در آزمون واقعی روی n8n 2.44.4، یک رویداد سه بار به هر دو ورک‌فلو فرستاده شد: نسخه ساده سه تیکت ساخت، نسخه ایدمپوتنت یکی (assets/duplicate-delivery-session.txt). در اجرای سوم نسخه ایدمپوتنت، گره حذف تکرار هیچ آیتمی عبور نداد و گره ثبت تیکت اصلاً اجرا نشد. این آزمون روی نشانی تولیدی Webhook و ورک‌فلوهای منتشرشده انجام شد.

تحویل اول رویداد به نسخه ایدمپوتنت در n8n که از حذف تکرار عبور می‌کند و تیکت می‌سازد

تحویل اول، نسخه ایدمپوتنت: یک تیکت

برای نگهداری وضعیت فراتر از «دیده شد یا نه»، n8n جدول‌های داده (Data tables) دارد؛ مستندات یکی از کاربردهایشان را «نشانه برای جلوگیری از اجرای تکراری» می‌داند، با سقف مشترک پیش‌فرض ۲۰۰ مگابایت برای همه جدول‌های نمونهsrc-n8n-data-tables.

گام ۴: دفتر مرحله‌ها برای چند اقدام

وقتی یک رویداد دو اقدام بیرونی دارد (تیکت، سپس پیام)، ترتیب ثبت مهم است. assets/partial_failure.py این را با SQLite نشان می‌دهد:

  • new → ticket_done: تیکت با کلید ساخته و شناسه‌اش ثبت می‌شود.
  • ticket_done → notifying: پیش از ارسال پیام ثبت می‌شود.
  • notifying → done: پس از ارسال.

اگر اجرا بین ارسال و ثبت قطع شود، وضعیت notifying می‌ماند؛ یعنی «شاید رفته». اجرای دوباره هرگز مرحله‌ای را که done است تکرار نمی‌کند و از جای درست ادامه می‌دهد.

گام ۵: آشتی پیش از تکرار

برای پیامی که کلید ندارد، اجرای دوباره از وضعیت notifying اول فهرست پیام‌های ارسال‌شده را برای همان شناسه رویداد می‌گردد؛ اگر پیدا شد، فقط وضعیت را done می‌کند. در اجرای واقعی اسکریپت، رویدادی که با آشتی دوباره اجرا شد یک پیام داشت و رویدادی که بدون آشتی دوباره اجرا شد، دو پیام (assets/partial-failure-run.txt).

برای اینکه آشتی ممکن باشد، شناسه رویداد را در خود اقدام بگذار (اینجا [evt-…] در متن پیام، یا یک شناسه در موضوع ایمیل یا فیلد مرجع). اگر سامانه بیرونی هیچ راهی برای جست‌وجو ندارد، تصمیم بگیر: برای پیام اطلاع‌رسانی شاید «یک بار کم» بهتر از «یک بار زیاد» باشد؛ برای پرداخت هرگز بدون کلید.

مثال‌ها

اجرای سوم نسخه ایدمپوتنت در n8n که گره حذف تکرار هیچ آیتمی به ثبت تیکت نمی‌دهد

تحویل سوم، نسخه ایدمپوتنت: ثبت تیکت اجرا نشد

اجرای سوم نسخه ساده در n8n که دوباره تیکت می‌سازد

تحویل سوم، نسخه ساده: تیکت سوم

پیاده‌سازی عملی

تحویل تکراری، قطع اجرا و آشتی. حدود ۲۲ دقیقه.

  1. API آزمایشی را اجرا کن (shared/barg-sabz-mock-api.py).
  2. یکی از مسیرهای پایین را برو.
  3. جدول اقدام‌های بیرونی یکی از ورک‌فلوهای خودت را بنویس: برای هر اقدام، ایدمپوتنت، کلید، upsert یا نیاز به دفتر و آشتی.
اجرای محلی

با Python: python partial_failure.py demo (فایل assets/partial_failure.py) را اجرا کن و خروجی را با assets/partial-failure-run.txt مقایسه کن. سپس در کد، ترتیب دو خط set_state(con, eid, "notifying") و ارسال پیام را جابه‌جا کن و پیش‌بینی کن چه چیزی خراب می‌شود. اگر n8n محلی داری: دو فایل ورک‌فلو را import کن، Credential «Barg Sabz mock API (Header Auth)» را بساز (مثل پروژه ۴)، هر دو را منتشر کن و هر رویداد را سه بار بفرست؛ تعداد تیکت‌ها را با GET /tickets بشمار.

بدون اجرا / شبیه‌ساز

بدون اجرا: assets/duplicate-delivery-session.txt و assets/partial-failure-run.txt را بخوان و سه اسکرین‌شات را ببین. بنویس: (۱) چرا نسخه ساده سه تیکت ساخت با اینکه فرستنده هر سه بار پاسخ 200 گرفت؛ (۲) در اجرای اسکریپت، کدام مرحله نشان می‌دهد آشتی جلوی پیام دوم را گرفت؛ (۳) اگر Webhook نسخه ایدمپوتنت «When Last Node Finishes» پاسخ می‌داد و ثبت تیکت ده ثانیه طول می‌کشید، چه انتظاری از فرستنده داشتی.

اشتباه‌های رایج

اشتباهنتیجهکار درست
فرض «هر رویداد یک بار»تیکت، پیام یا پرداخت تکراریحذف تکرار و کلید
کلید ایدمپوتنسی تصادفی برای هر تلاشکلید بی‌اثر؛ تلاش دوباره کلید تازه داردکلید از شناسه رویداد، ثابت در همه تلاش‌ها
ثبت وضعیت فقط پس از اقدامپس از قطع، اقدام دوبارهثبت «در حال انجام» پیش و «انجام‌شده» پس از اقدام
Retry On Fail روی ارسال بی‌کلیدپیام تکراریتلاش دوباره فقط برای اقدام ایدمپوتنت
پاسخ Webhook پس از پایان کار سنگینtimeout و تحویل دوبارهپاسخ فوری، پردازش بعدی
insert به‌جای upsert در جدولردیف تکراریستون کلید یکتا و upsert

اشکال‌زدایی

برای یک سفارش دو یا چند تیکت با فاصله چند ثانیه ساخته شده است.

فرستنده Webhook پس از timeout دوباره فرستاده و ورک‌فلو هیچ حذف تکرار یا کلیدی ندارد.

در Executions چند اجرا با همان event_id و زمان نزدیک؛ در لاگ فرستنده، تلاش دوباره.

پاسخ فوری، Remove Duplicates روی شناسه رویداد و کلید ایدمپوتنسی در اقدام.

پس از قطع سرور، اجرای دوباره، پیام مشتری را دوباره فرستاد.

وضعیت «در حال ارسال» پیش از اقدام ثبت نمی‌شد، یا اجرای دوباره بدون آشتی پیام را فرستاد.

دفتر مرحله‌ها برای آن رویداد؛ فهرست پیام‌های ارسال‌شده با شناسه رویداد.

ثبت پیش و پس از اقدام، شناسه رویداد در خود پیام، و آشتی پیش از تکرار.

پس از چند ماه، رویدادهای قدیمی دوباره پردازش می‌شوند.

تاریخچه حذف تکرار به سقف اندازه (پیش‌فرض ۱۰٬۰۰۰) رسیده و مقدارهای قدیمی بیرون رفته‌اند، یا تاریخچه پاک شده استsrc-n8n-remove-duplicates.

تعداد رویدادهای یکتا در بازه را با History Size مقایسه کن.

History Size متناسب، کلید ایدمپوتنسی به‌عنوان لایه دوم، یا جدول دفتر با کلید یکتا.

تمرین کوتاه

تمرین · 12 دقیقه

هدف: طبقه‌بندی اقدام‌ها.

گام‌ها: ورک‌فلوی «سفارش تازه» این اقدام‌ها را دارد: (۱) خواندن جزئیات سفارش با GET؛ (۲) افزودن ردیف به Google Sheets گزارش فروش؛ (۳) ساخت تیکت در API تیکت با Idempotency-Key؛ (۴) ارسال پیامک تأیید سفارش با سرویسی که کلید ندارد؛ (۵) کم‌کردن موجودی انبار با POST /stock/decrement. برای هر اقدام بنویس با تکرار چه می‌شود و راه کنترلش چیست.

معیار پذیرش: ۱ بی‌خطر؛ ۲ با upsert روی شماره سفارش؛ ۳ با کلید ثابت؛ ۴ با دفتر و آشتی یا انتخاب آگاهانه؛ ۵ خطرناک‌ترین، نیازمند کلید یا عملیات «تنظیم مقدار» به‌جای «کم‌کردن».

راه‌حل نمونه

(۱) GET ایدمپوتنت است؛ تکرارش فقط هزینه است. (۲) «افزودن» ردیف تکراری می‌سازد؛ به «افزودن یا به‌روزرسانی» با ستون شماره سفارش تغییرش بده. (۳) با کلید ثابت (شناسه رویداد یا سفارش) تکرار بی‌اثر است؛ کلید تصادفی بی‌فایده است. (۴) پیامک بی‌کلید: دفتر مرحله‌ها با ثبت پیش و پس، شناسه سفارش در متن، و اگر سرویس فهرست ارسال‌شده‌ها را می‌دهد، آشتی؛ وگرنه انتخاب آگاهانه (برای تأیید سفارش، «یک بار کم» با پیگیری دستی قابل قبول‌تر از «دو پیامک» است؟ تصمیم را ثبت کن). (۵) هر تکرار موجودی را دوباره کم می‌کند و داده را خراب می‌کند؛ از API بخواه کلید ایدمپوتنسی بپذیرد، یا به عملیات «تنظیم موجودی برای این سفارش» تبدیلش کن که تکرارش همان نتیجه را دارد.

چالش

تمرین · 35 دقیقه

موقعیت: یکی از ورک‌فلوهای خودت که دست‌کم دو اقدام بیرونی دارد را برای «تحویل تکراری» و «قطع وسط کار» بازطراحی کن. اگر داده واقعی است، آزمون را با داده ساختگی یا ناشناس‌شده انجام بده.

  1. جدول اقدام‌ها با نوع کنترل هرکدام.
  2. طراحی دفتر مرحله‌ها: وضعیت‌ها، کلید یکتا و جای نگهداری.
  3. پیاده‌سازی (n8n یا کد) و سه آزمون: تحویل سه‌باره، قطع پس از اقدام اول، قطع پس از اقدام دوم و پیش از ثبت.
  4. تصمیم مکتوب برای هر اقدامی که نه کلید دارد نه آشتی.

خروجی مورد انتظار: جدول اقدام‌ها، طرح دفتر، شاهد سه آزمون و تصمیم مکتوب.

معیار پذیرش:

  • تحویل سه‌باره فقط یک اثر بیرونی برای هر اقدام دارد.
  • اجرای دوباره پس از قطع، از مرحله درست ادامه می‌دهد.
  • هر اقدام بی‌کلید یا آشتی دارد یا تصمیم مکتوب.

پرسش‌های سنجش

جمع‌بندی

  • تحویل دست‌کم یک‌باره و قطع وسط کار عادی‌اند، نه استثنا.
  • برای هر اقدام بیرونی: ایدمپوتنت، کلید، upsert، یا دفتر و آشتی.
  • در n8n دو لایه: Remove Duplicates روی شناسه رویداد و Idempotency-Key ثابت.
  • دفتر مرحله‌ها: ثبت «در حال انجام» پیش از اقدام و «انجام‌شده» پس از آن.
  • پیش از تکرار اقدامی که شاید انجام شده، آشتی بده؛ شناسه رویداد را در خود اقدام بگذار.
  • Retry On Fail فقط برای اقدام ایدمپوتنت یا کلیددار.

پرسش‌های سنجش

سه موقعیت: (الف) فرستنده Webhook پس از ۱۰ ثانیه بی‌پاسخ، دوباره می‌فرستد و ورک‌فلوی تو ۱۵ ثانیه کار می‌کند؛ (ب) زمان‌بند پس از به‌روزرسانی سرور، اجرای ساعت ۹ را دو بار انجام داد؛ (ج) گره ارسال پیام با Retry On Fail پس از timeout دوباره اجرا شد. در هرکدام چه چیزی تکرار می‌شود و یک کنترل بنویس.

پاسخ نمونه و معیار ارزیابی

(الف) کل اجرا برای همان رویداد دوباره؛ کنترل: پاسخ فوری و حذف تکرار روی شناسه رویداد. (ب) همه اقدام‌های آن اجرا؛ کنترل: کلید یا دفتر با شناسه «اجرای ۹ صبح این تاریخ» و کنار گذاشتن اجرای دوم. (ج) فقط ارسال پیام، ولی شاید پیام اول رسیده بود (timeout یعنی نمی‌دانیم)؛ کنترل: تلاش دوباره خودکار روی اقدام بی‌کلید را خاموش کن و از دفتر و آشتی استفاده کن.

  • الف: پاسخ فوری و حذف تکرار (1 امتیاز)
  • ب: شناسه اجرا یا دوره (1 امتیاز)
  • ج: timeout یعنی ناشناخته و آشتی (1 امتیاز)
  • timeout یعنی نرفته ← timeout یعنی پاسخ نرسید؛ ممکن است اقدام انجام شده باشد.

با این تنظیم هنوز تیکت تکراری ساخته می‌شود. چرا، و کلید درست چیست؟

تنظیم گره ثبت تیکت:

Header: Idempotency-Key = {{ $now.toMillis() }}-{{ Math.random() }}
Retry On Fail: on, Max Tries: 3
پاسخ نمونه و معیار ارزیابی

کلید در هر تلاش و هر اجرا تازه ساخته می‌شود (زمان و عدد تصادفی)، پس سرور هر درخواست را درخواست تازه می‌بیند و کلید هیچ اثری ندارد. کلید باید از هویت پایدار اقدام بیاید و در همه تلاش‌ها و اجراهای دوباره ثابت بماند، مثلاً شناسه رویداد یا ترکیب «ticket-» و شماره سفارش و نوع رویداد.

  • کلید در هر تلاش عوض می‌شود (1 امتیاز)
  • کلید از شناسه پایدار رویداد (1 امتیاز)
  • Retry را خاموش کن ← تکرار از فرستنده و اجرای دوباره هم می‌آید؛ مسئله کلید است.

رویداد «سفارش لغو شد» سه اقدام دارد: لغو در سامانه انبار (کلید می‌پذیرد)، بازگشت وجه در درگاه (کلید می‌پذیرد)، و ایمیل به مشتری (کلید ندارد). وضعیت‌های دفتر مرحله‌ها و ترتیب ثبت را بنویس.

پاسخ نمونه و معیار ارزیابی

وضعیت‌ها: new → stock_done → refund_done → emailing → done. برای انبار و بازگشت وجه، کلید ثابت از شناسه رویداد و نوع اقدام (مثل cancel-<event>-stock و cancel-<event>-refund) و ثبت وضعیت پس از موفقیت؛ تکرار با همان کلید بی‌اثر است. برای ایمیل: پیش از ارسال emailing ثبت شود، شناسه رویداد در موضوع یا متن باشد، پس از ارسال done؛ اجرای دوباره از emailing اول صندوق ارسال را برای آن شناسه می‌گردد. اجرای دوباره هر مرحله done را رد می‌کند.

  • وضعیت‌های مرحله‌ای به ترتیب (1 امتیاز)
  • کلید جدا و ثابت برای هر اقدام کلیددار (1 امتیاز)
  • ثبت پیش و پس برای ایمیل و آشتی (1 امتیاز)
  • یک کلید برای همه ← هر اقدام کلید خودش را می‌خواهد؛ در سرویس‌های مختلف یا عملیات مختلف همان کلید معنای دیگری دارد.

در دفتر مرحله‌ها، رویدادی در وضعیت «در حال ارسال» مانده و سامانه پیام فهرست پیام‌های ارسال‌شده را با متن می‌دهد. اجرای دوباره چه باید بکند؟

  • پیام را دوباره بفرستد؛ بهتر است دو بار برسد تا هیچ.
  • فهرست ارسال‌شده‌ها را برای شناسه رویداد بگردد؛ اگر پیدا شد فقط وضعیت را «انجام‌شده» کند، وگرنه بفرستد.
  • رویداد را بی‌صدا «انجام‌شده» علامت بزند.
  • کل رویداد را از اول اجرا کند.
پاسخ نمونه و معیار ارزیابی
  • a ← وقتی می‌شود بررسی کرد، فرستادن کورکورانه تکرار ساختن است.
  • c ← شاید پیام نرفته باشد؛ بدون بررسی، مشتری بی‌خبر می‌ماند.
  • d ← مرحله‌های انجام‌شده نباید تکرار شوند.

برای جلوگیری از تیکت تکراری، یکی می‌گوید «فقط Remove Duplicates کافی است» و دیگری «فقط کلید ایدمپوتنسی». موازنه هر کدام و انتخاب خودت را بنویس.

پاسخ نمونه و معیار ارزیابی

Remove Duplicates پیش از هر فراخوانی جلوی کار تکراری را می‌گیرد و هزینه و فشار روی سرویس را کم می‌کند، ولی تاریخچه‌اش داخل n8n است، سقف اندازه دارد و ممکن است پاک شود؛ و اگر اجرا پس از عبور از آن و پیش از اقدام قطع شود، رویداد دیگر عبور نمی‌کند (شاید هرگز انجام نشود). کلید ایدمپوتنسی در خود سرویس بیرونی تکرار را بی‌اثر می‌کند و به وضعیت n8n وابسته نیست، ولی فقط وقتی سرویس آن را بپذیرد و هر تکرار هنوز یک فراخوانی است. انتخاب: هر دو در جایی که سرویس کلید می‌پذیرد؛ و برای قطع پس از حذف تکرار، دفتر مرحله‌ها یا قراردادن حذف تکرار پس از اقدام.

  • مزیت و ضعف حذف تکرار (سقف، پاک شدن، قطع پس از عبور) (1 امتیاز)
  • مزیت و شرط کلید (1 امتیاز)
  • ترکیب با دلیل (1 امتیاز)
  • یکی کافی است ← هر لایه شکست خودش را دارد؛ دو لایه مستقل خطای هم را می‌پوشانند.

فایل‌های درس

ورک‌فلوی ساده که با هر تحویل تیکت تازه می‌سازد (غیرفعال)

n8n-events-naive.json

ورک‌فلوی ایدمپوتنت با Remove Duplicates و Idempotency-Key (غیرفعال)

n8n-events-idempotent.json

خروجی واقعی سه بار تحویل یک رویداد به هر دو ورک‌فلو

duplicate-delivery-session.txt

دفتر مرحله‌ها و آشتی با شبیه‌سازی قطع اجرا

partial_failure.py

خروجی واقعی اجرای partial_failure.py

partial-failure-run.txt

اسکرین‌شات تحویل اول در نسخه ایدمپوتنت

n8n-idempotent-first-delivery.webp

اسکرین‌شات تحویل سوم: هیچ آیتمی از حذف تکرار عبور نمی‌کند

n8n-idempotent-third-delivery.webp

اسکرین‌شات تحویل سوم در نسخه ساده: تیکت سوم ساخته می‌شود

n8n-naive-third-delivery.webp

API آزمایشی با تیکت ایدمپوتنت و پیام‌رسان بدون کلید

barg-sabz-mock-api.py

ابزارها و جایگزین‌ها

  • Python 3.9 یا بالاتر و API آزمایشی برگ سبز — دفتر مرحله‌ها و آشتی — مسیر بدون اجرا با خروجی واقعی

منابع

Webhook node n8n n8n docs, 2026-10

Idempotent (Glossary) MDN Web Docs (Mozilla) living doc, accessed 2026-10-16

Gmail node message operations n8n n8n docs, 2026-10

Remove Duplicates node n8n n8n docs, 2026-10 (node overhauled in 1.64.0)

Data tables n8n n8n docs, 2026-10

دوره

n8n در تولید