نصب، راه‌اندازی و تنظیمات ربات

آموزش Error Handling در MT5

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

مشاوره و سفارش ربات:واتس‌اپتلگرام۰۹۱۷۱۷۹۲۵۸۱

پاسخ کوتاه: Error Handling در MT5 یعنی اکسپرت بعد از هر کار مهم نتیجه را بخواند و موفقیت را فرض نکند. دو منبع خطا را جدا بشناسید: خطای اجرای برنامه که با GetLastError خوانده می‌شود، و پاسخ سرور معاملاتی که در retcode می‌آید. برای هر کد هم واکنش مشخص بنویسید: تلاش دوباره، توقف، یا اصلاح ورودی.

دو جور خطا در MQL5

خطای اجرای برنامه. هر برنامهٔ MQL5 یک متغیر _LastError دارد که پیش از OnInit صفر می‌شود. وقتی تابعی به مشکل بخورد، کد خطا در آن می‌نشیند و با GetLastError() خوانده می‌شود. پیش از هر فراخوانی مهم ResetLastError() را صدا بزنید، وگرنه ممکن است خطای قدیمی را به حساب کار تازه بگذارید.

پاسخ سرور معاملاتی. OrderSend وقتی true برمی‌گرداند که بررسی اولیهٔ ساختار درخواست موفق باشد. به گفتهٔ مستندات MQL5 این به معنای اجرای معامله نیست. نتیجهٔ واقعی در result.retcode است، مثلاً ۱۰۰۰۹ یعنی انجام شد و ۱۰۰۱۹ یعنی موجودی کافی نیست.

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

واکنش درست به کدهای رایج سرور

retcode معنا واکنش
۱۰۰۰۹، ۱۰۰۰۸ انجام شد یا سفارش ثبت شد ادامه
۱۰۰۱۰ فقط بخشی انجام شد حجم انجام‌شده را از result.volume بخوانید
۱۰۰۰۴، ۱۰۰۲۰ ری‌کوت یا تغییر قیمت با قیمت تازه، چند بار محدود دوباره بفرستید
۱۰۰۲۱، ۱۰۰۲۴، ۱۰۰۳۱ نبود قیمت، درخواست زیاد، قطع ارتباط با سرور کمی صبر کنید و دوباره بفرستید
۱۰۰۱۲ لغو به‌خاطر پایان مهلت پیش از ارسال دوباره، پوزیشن‌ها را بخوانید تا دو بار باز نشود
۱۰۰۱۴، ۱۰۰۱۵، ۱۰۰۱۶، ۱۰۰۳۰ حجم، قیمت، حد ضرر و سود یا نوع پر شدن نادرست تکرار نکنید؛ ورودی را اصلاح کنید
۱۰۰۱۹ موجودی کافی نیست تکرار نکنید؛ حجم را کم کنید
۱۰۰۱۷، ۱۰۰۱۸ معامله ممنوع یا بازار بسته تکرار نکنید؛ ساعت معاملهٔ نماد و اجازهٔ معامله در حساب را ببینید
۱۰۰۲۶، ۱۰۰۲۷ معاملهٔ خودکار در سرور یا ترمینال خاموش است دکمهٔ Algo Trading یا تنظیم بروکر را ببینید

خطای ۱۰۰۳۰ را جدا در خطای Unsupported filling mode در MQL5 توضیح داده‌ایم. فهرست کامل کدها را در بررسی Error Code ها در برنامه‌نویسی ربات ببینید.

کد MQL5: بررسی پیش از ارسال و تلاش دوباره با سقف

این دو تابع درخواست را پیش از ارسال با OrderCheck می‌سنجند، پاسخ سرور را دسته‌بندی می‌کنند و فقط خطاهای موقت را با قیمت تازه و حداکثر سه بار دوباره می‌فرستند:

enum TradeOutcome { OUTCOME_DONE, OUTCOME_RETRY, OUTCOME_FAIL };

// Sorts a trade server return code into done, worth retrying, or stop
TradeOutcome Classify(const uint retcode)
  {
   switch(retcode)
     {
      case TRADE_RETCODE_DONE:
      case TRADE_RETCODE_PLACED:
      case TRADE_RETCODE_DONE_PARTIAL:
         return(OUTCOME_DONE);
      case TRADE_RETCODE_REQUOTE:
      case TRADE_RETCODE_PRICE_CHANGED:
      case TRADE_RETCODE_PRICE_OFF:
      case TRADE_RETCODE_TOO_MANY_REQUESTS:
      case TRADE_RETCODE_CONNECTION:
         return(OUTCOME_RETRY);
      default:
         return(OUTCOME_FAIL);  // bad volume or stops, no money, market closed, timeout ...
     }
  }

// Sends a market order with a fresh price, at most maxTries times
bool SendWithRetry(MqlTradeRequest &request,MqlTradeResult &result,const int maxTries=3)
  {
   for(int attempt=1; attempt<=maxTries; attempt++)
     {
      if(request.action==TRADE_ACTION_DEAL)
         request.price=(request.type==ORDER_TYPE_BUY)
                       ? SymbolInfoDouble(request.symbol,SYMBOL_ASK)
                       : SymbolInfoDouble(request.symbol,SYMBOL_BID);
      MqlTradeCheckResult check={};
      ResetLastError();
      if(!OrderCheck(request,check))
        {
         PrintFormat("OrderCheck: retcode %u (%s), error %d",check.retcode,check.comment,GetLastError());
         return(false);                   // fix the request; sending it again will not help
        }
      ZeroMemory(result);
      ResetLastError();
      bool sent=OrderSend(request,result);
      TradeOutcome outcome=Classify(result.retcode);
      PrintFormat("Attempt %d: retcode %u (%s), error %d",attempt,result.retcode,result.comment,GetLastError());
      if(sent && outcome==OUTCOME_DONE)
         return(true);
      if(outcome==OUTCOME_FAIL)
         return(false);
      Sleep(500*attempt);                 // a short pause before the next try
     }
   return(false);
  }

چند نکته دربارهٔ این کد:

  • OrderCheck: اگر موجودی کافی نباشد یا درخواست درست پر نشده باشد، false برمی‌گرداند و علت در check.retcode است. true هم تضمین اجرا نیست؛ فقط یعنی بررسی اولیه گذشته است.
  • پایان مهلت (۱۰۰۱۲): عمداً در گروه «توقف» است. پیش از ارسال دوباره، با PositionSelect یا تاریخچه ببینید معامله باز شده یا نه.
  • سقف تلاش: بدون سقف، ربات در ساعت خبر یا قطعی سرور با تکرار درخواست‌ها خودش خطای ۱۰۰۲۴ (درخواست زیاد) می‌سازد.

طراحی Retry، اثر اسپرد و Stops Level و تفاوت حساب‌های Netting و Hedging را با جزئیات بیشتر در مدیریت خطاهای OrderSend در ربات آورده‌ایم. پایهٔ ارسال سفارش هم در آموزش ارسال سفارش Buy و Sell در MQL5 است.

لاگی که بعداً به کار بیاید

هر Print و PrintFormat در زبانهٔ Experts ترمینال و فایل لاگ روزانهٔ پوشهٔ MQL5\Logs می‌نشیند. لاگ وقتی مفید است که از روی آن بشود فهمید چه شد، پس در هر خط این‌ها را بیاورید:

  • نام نماد و نوع سفارش؛
  • retcode و متن comment سرور، و شمارهٔ GetLastError؛
  • شمارهٔ تلاش و قیمتی که فرستاده شد.

هر تیک لاگ ننویسید؛ فقط وقتی اتفاقی می‌افتد. لاگ پرحجم هم خطای واقعی را پنهان می‌کند و هم ترمینال را کند.

مدیریت خطا را چطور تست کنیم؟

در تستر متاتریدر ۵، حالت No Delay همهٔ سفارش‌ها را بی ری‌کوت و دقیقاً به قیمت درخواستی اجرا می‌کند. پس کدی که فقط در این حالت تست شده، شاخهٔ خطایش هیچ‌وقت اجرا نشده است. در تنظیم Delays حالت Random Delay یا یک تأخیر ثابت نزدیک به پینگ سرور خودتان را انتخاب کنید. بعد ربات را چند هفته روی حساب دمو همان بروکر اجرا کنید و لاگ را بخوانید. روش کامل کار با تستر در آموزش استفاده از Strategy Tester در متاتریدر آمده است.

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

پرسش‌های پرتکرار

تفاوت GetLastError و retcode چیست؟

GetLastError خطای اجرای خود برنامه را می‌گوید، مثل پارامتر نادرست یا نبودن داده. retcode پاسخ سرور معاملاتی به درخواست شماست. بعد از OrderSend هر دو را بخوانید.

چند بار باید سفارش را دوباره فرستاد؟

عدد ثابتی نیست. دو تا سه بار با مکث کوتاه برای ری‌کوت و تغییر قیمت معمول است. برای خطاهای دائم، مثل موجودی ناکافی یا حجم نادرست، اصلاً نباید تکرار کرد.

چرا اکسپرت بدون هیچ پیامی متوقف شد؟

اغلب یکی از خطاهای بحرانی رخ داده است: تقسیم بر صفر، بیرون رفتن از آرایه، یا اشاره‌گر نامعتبر. روی نمودار پیامی دیده نمی‌شود، ولی زبانهٔ Experts ترمینال همان لحظه نام خطا و شمارهٔ خط کد را ثبت می‌کند.

منابع

هشدار ریسک: این مطلب جنبه آموزشی دارد و توصیه سرمایه‌گذاری نیست. معامله در بازارهای مالی با ریسک از دست دادن سرمایه همراه است و نتایج گذشته یا بک‌تست تضمینی برای آینده نیست.

نویسنده

تیم متااکسپرت در طراحی و برنامه‌نویسی ربات‌های معامله‌گر و اکسپرت‌های متاتریدر با MQL4 و MQL5 تخصص دارد و تجربه‌های عملی خود را در قالب این مقالات منتشر می‌کند.

دیدگاه‌ها

دیدگاه یا سؤال خود را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

کد امنیتی