Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Codes d’erreur

GetLastError en MQL5 : lire, réinitialiser et journaliser les erreurs

GetLastError, ResetLastError et _LastError : comment lire le bon code au bon moment, éviter les erreurs fantômes et journaliser proprement les échecs d’un EA MQL5.

Mis à jour le 23 octobre 2026Lecture : 6 minPar Alix, OptiBot Trading

GetLastError() renvoie le code de la dernière erreur d’exécution survenue dans votre programme MQL5. Ce code est stocké dans la variable prédéfinie _LastError, que la fonction se contente de lire : les deux sont équivalents. La règle essentielle tient en une phrase : appelez ResetLastError() juste avant l’opération à surveiller, puis lisez GetLastError() juste après. Sinon, vous risquez d’attribuer à votre appel une erreur produite bien plus tôt.

Cette page détaille le mécanisme, ses pièges et une façon propre de l’intégrer à un Expert Advisor. Pour la vue d’ensemble des différentes familles de codes, voyez la page de rubrique Codes d’erreur et de retour MQL5.

Comment fonctionne _LastError

Chaque programme MQL5 possède sa propre variable _LastError. La documentation précise qu’elle est remise à zéro avant l’appel de OnInit(), puis mise à jour chaque fois qu’une fonction système échoue. Trois propriétés en découlent :

  • Un succès n’efface pas l’erreur. Si CopyBuffer() échoue, puis que dix fonctions réussissent, GetLastError() renvoie toujours le code de l’échec de CopyBuffer().
  • Lire n’efface pas non plus. Appeler GetLastError() ne remet pas la valeur à zéro, contrairement à ce qui se passait en MQL4.
  • Seul ResetLastError() remet le compteur à 0 (ERR_SUCCESS, « The operation completed successfully »).

La conséquence pratique est directe : un test du type if(GetLastError() != 0) placé au milieu de OnTick() sans réinitialisation préalable vous signalera indéfiniment la même erreur ancienne.

La séquence correcte

// Exemple : lecture d'un buffer d'indicateur avec contrôle d'erreur
double ma[];
ArraySetAsSeries(ma, true);

ResetLastError();                                   // 1. on part de zéro
int copied = CopyBuffer(maHandle, 0, 0, 3, ma);     // 2. l'opération surveillée
if(copied < 3)                                      // 3. on teste d'abord la valeur renvoyée
  {
   int err = GetLastError();                        // 4. puis on lit le code immédiatement
   PrintFormat("CopyBuffer : %d valeurs au lieu de 3, erreur %d", copied, err);
   return;
  }

Notez l’ordre : on teste d’abord la valeur de retour de la fonction, et l’on ne consulte GetLastError() que pour comprendre un échec. Un code non nul ne prouve pas à lui seul que l’appel courant a échoué si vous avez oublié la réinitialisation ; une valeur de retour anormale, si.

Les codes que vous verrez le plus souvent

La table officielle des erreurs d’exécution est longue. En pratique, dans un EA de trading, une poignée revient régulièrement :

CodeConstanteSignification officielle
0ERR_SUCCESSThe operation completed successfully
4003ERR_INVALID_PARAMETERWrong parameter when calling the system function
4012ERR_INVALID_POINTERWrong pointer
4752ERR_TRADE_DISABLEDTrading by Expert Advisors prohibited
4753ERR_TRADE_POSITION_NOT_FOUNDPosition not found
4754ERR_TRADE_ORDER_NOT_FOUNDOrder not found
4756ERR_TRADE_SEND_FAILEDTrade request sending failed
4758ERR_TRADE_CALC_FAILEDFailed to calculate profit or margin
5052ERR_SMALL_ARRAYToo small array, the starting position is outside the array

Le code 4756 mérite une page à part : il signale un échec de OrderSend() mais ne dit pas pourquoi. La cause réelle se trouve dans le retcode du serveur, détaillé sur la page 4756 Échec d’envoi de la requête.

GetLastError ne couvre pas tout

Deux catégories d’incidents échappent à GetLastError() :

  • Les réponses du serveur de trading. Un ordre refusé pour stops invalides produit TRADE_RETCODE_INVALID_STOPS (10016) dans MqlTradeResult.retcode. Ce code n’est pas une erreur d’exécution du terminal. Consultez la page Codes de retour du serveur de trading.
  • Les erreurs critiques. Division par zéro, dépassement de tableau et pointeur incorrect terminent immédiatement le programme : il n’y a plus de code à lire puisque plus rien ne s’exécute.

Une fonction de journalisation réutilisable

Plutôt que de disperser des Print() partout, regroupez la lecture et l’affichage dans une petite fonction. Le nom de l’opération en paramètre rend le journal lisible plusieurs semaines plus tard.

//+------------------------------------------------------------------+
//| Journalise le dernier code d'erreur et le remet à zéro           |
//| Renvoie true s'il y avait une erreur                             |
//+------------------------------------------------------------------+
bool LogLastError(const string operation)
  {
   int err = GetLastError();
   if(err == 0)
      return false;
   PrintFormat("[%s] %s a échoué, code %d", _Symbol, operation, err);
   ResetLastError();          // évite de rejouer la même erreur au prochain contrôle
   return true;
  }

int maHandle = INVALID_HANDLE;

int OnInit()
  {
   ResetLastError();
   maHandle = iMA(_Symbol, PERIOD_CURRENT, 50, 0, MODE_SMA, PRICE_CLOSE);
   if(maHandle == INVALID_HANDLE)
     {
      LogLastError("iMA");
      return INIT_FAILED;     // inutile de continuer sans indicateur
     }
   return INIT_SUCCEEDED;
  }

void OnTick()
  {
   double ma[];
   ArraySetAsSeries(ma, true);
   ResetLastError();
   if(CopyBuffer(maHandle, 0, 0, 2, ma) < 2)
     {
      LogLastError("CopyBuffer MA50");
      return;                 // on attend le tick suivant
     }
   // ... logique de signal ...
  }

Juste après le chargement d’un graphique ou le lancement du terminal, il est normal que les toutes premières copies de données échouent le temps que l’historique soit calculé. Le return laisse simplement passer le tick ; il ne faut pas transformer cet état transitoire en INIT_FAILED.

Où placer les contrôles dans un EA

Inutile de contrôler chaque ligne. Concentrez les vérifications sur les opérations qui dépendent de l’environnement extérieur et peuvent échouer sans que votre code soit en cause :

  • Dans OnInit() : création des handles d’indicateurs, ouverture de fichiers, lecture des propriétés du symbole. Un échec ici justifie souvent de renvoyer INIT_FAILED avec un message clair, plutôt que de laisser l’EA tourner à vide.
  • Dans OnTick() : copie des données (CopyRates(), CopyBuffer()), lecture du dernier tick, envoi et modification d’ordres. Ici, un échec ponctuel ne doit pas arrêter le programme ; on journalise et on attend le tick suivant.
  • Dans OnDeinit() : libération des handles et sauvegarde d’état. Une erreur à ce moment n’empêche rien, mais la tracer aide à comprendre un redémarrage raté.

Cette répartition évite deux excès : un EA muet qui échoue sans rien dire, et un journal saturé de messages sans valeur.

Pièges fréquents

Lire l’erreur trop tard

Entre l’appel qui échoue et la lecture du code, toute autre fonction système appelée entre-temps peut écraser _LastError avec son propre code : la documentation recommande de lire la valeur juste après l’instruction concernée. Stockez le code dans une variable locale dès la ligne suivante, comme dans les exemples ci-dessus.

Confondre 0 et « pas de problème »

Certaines fonctions renvoient une valeur valide tout en ayant rencontré un souci, d’autres renvoient une valeur d’échec sans positionner d’erreur particulière. La valeur de retour reste votre premier indicateur ; le code d’erreur est un complément de diagnostic.

Ignorer l’erreur 4752

Le code ERR_TRADE_DISABLED (4752, « Trading by Expert Advisors prohibited ») apparaît notamment quand le trading algorithmique est coupé dans le terminal. Il est souvent associé, côté serveur, au retcode 10027 : voyez 10027 Trading automatique désactivé.

Oublier le testeur

Dans le Strategy Tester, les erreurs s’affichent dans l’onglet Journal du testeur, pas dans l’onglet Experts du terminal. Prenez l’habitude de le consulter après chaque backtest : un EA qui « ne trade pas » dans le testeur a souvent laissé une trace explicite.

Cas d’usage : un EA silencieux en production

Un utilisateur lance un EA sur un VPS ; aucun trade en trois jours. Sans journalisation, impossible de savoir si le signal n’est jamais apparu ou si les ordres ont échoué. Avec la fonction LogLastError() ci-dessus appelée après chaque opération sensible, l’onglet Experts aurait affiché par exemple « CopyBuffer MA50 a échoué » en boucle, révélant un handle créé sur un mauvais symbole, ou « OrderSend a échoué, code 4756 », orientant vers le retcode du serveur. Cette discipline est détaillée plus largement dans Print, Comment, Alert : déboguer avec le journal.

Une gestion d’erreur rigoureuse réduit les comportements imprévus, mais ne protège pas d’une perte de marché. Testez toujours un EA sur compte démo avant de l’exposer à des fonds réels.

Questions fréquentes

Quelle différence entre GetLastError() et _LastError ?

Aucune sur le fond : GetLastError() renvoie la valeur de la variable prédéfinie _LastError. La documentation présente la différence comme purement syntaxique.

GetLastError remet-il l’erreur à zéro en MQL5 ?

Non. Contrairement à MQL4, la lecture ne réinitialise pas le code. Il faut appeler explicitement ResetLastError() avant l’opération à contrôler.

Pourquoi GetLastError renvoie 0 alors que mon ordre est refusé ?

Parce que le refus vient du serveur : il se lit dans MqlTradeResult.retcode, pas dans les erreurs d’exécution. Si OrderSend() a renvoyé true, le terminal considère que la requête a bien été transmise, même si le serveur l’a ensuite refusée.

Comment obtenir le texte d’un code d’erreur ?

MQL5 ne fournit pas de fonction standard qui convertit un code d’exécution 4xxx en texte. Pour les retcodes de trading, la classe CTrade propose ResultRetcodeDescription(). Pour le reste, tenez une table de correspondance dans votre code à partir de la documentation.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.