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

MQL4 · Bases

Déboguer en MQL4 : journal, Print, GetLastError et débogueur

Print, Comment, GetLastError, points d’arrêt et testeur visuel : la méthode pour trouver et corriger un bug dans un Expert Advisor MQL4, du symptôme dans le journal à la correction.

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

Déboguer un programme MQL4 repose sur trois outils complémentaires : le journal (messages écrits avec Print() ou PrintFormat() et affichés dans l’onglet Experts du terminal ou l’onglet Journal du testeur), l’affichage sur le graphique avec Comment(), et le débogueur de MetaEditor, qui permet de poser des points d’arrêt, d’exécuter le code pas à pas et d’inspecter les variables. Dans la pratique, la combinaison la plus efficace consiste à journaliser systématiquement les codes d’erreur renvoyés par GetLastError() et à n’ouvrir le débogueur que pour comprendre un comportement que le journal ne suffit pas à expliquer.

Cette page présente une méthode complète pour trouver un bug dans un EA MQL4, du symptôme à la correction. Elle fait partie de la rubrique Les bases du MQL4.

Les outils de sortie

FonctionOù le message apparaîtUsage
Print()Onglet Experts du terminal, Journal du testeur, fichiers journauxTraces durables, erreurs, décisions de trading
PrintFormat()Même destination que Print()Messages formatés, à la manière de printf en C
Comment()Coin supérieur gauche du graphiqueÉtat courant : signal, spread, nombre d’ordres
Alert()Fenêtre d’alerte avec sonÉvénements rares qui exigent l’attention de l’utilisateur

Les messages de l’onglet Experts sont aussi enregistrés dans des fichiers texte, un par jour, dans le dossier MQL4/Logs du répertoire de données (menu Fichier, puis Ouvrir le dossier des données). Les journaux du testeur sont rangés à part, dans le dossier tester/logs. Ces fichiers sont précieux pour analyser un incident survenu pendant la nuit sur un VPS.

Comment() remplace son texte à chaque appel : c’est un tableau de bord, pas un historique. N’y mettez pas d’information que vous voudrez relire plus tard.

Journaliser les erreurs correctement

La plupart des fonctions de trading renvoient false ou -1 en cas d’échec et placent un code dans _LastError. Le réflexe à prendre : réinitialiser le code avant l’appel, tester la valeur de retour, et seulement alors lire l’erreur.

#property strict
#include <stdlib.mqh>               // fournit ErrorDescription()

input int InpMagic = 240108;        // Numéro magique
input bool InpDebug = true;         // Afficher les traces détaillées

//+------------------------------------------------------------------+
//| Trace conditionnelle : n'écrit que si InpDebug est vrai           |
//+------------------------------------------------------------------+
void Trace(string msg)
  {
   if(InpDebug)
      Print("[DEBUG] ", msg);
  }

//+------------------------------------------------------------------+
//| Journalise un échec avec le code et sa description                |
//+------------------------------------------------------------------+
void LogErreur(string contexte)
  {
   int err = GetLastError();
   PrintFormat("[ERREUR] %s : code %d (%s) | Bid=%s Ask=%s",
               contexte, err, ErrorDescription(err),
               DoubleToString(Bid, Digits), DoubleToString(Ask, Digits));
  }

void OnTick()
  {
   double sl = NormalizeDouble(Bid - 300 * Point, Digits);
   Trace(StringFormat("Tentative d'achat, SL=%s", DoubleToString(sl, Digits)));

   ResetLastError();
   int ticket = OrderSend(Symbol(), OP_BUY, 0.10, Ask, 10, sl, 0,
                          "debug", InpMagic, 0, clrNONE);
   if(ticket < 0)
      LogErreur("OrderSend achat");
   else
      Trace(StringFormat("Ordre ouvert, ticket %d", ticket));

   // tableau de bord sur le graphique
   Comment("Spread : ", DoubleToString((Ask - Bid) / Point, 0), " points\n",
           "Ordres ouverts : ", OrdersTotal());
  }

Ce modèle illustre trois principes. Le message d’erreur contient le contexte (quelle opération), le code et sa description lisible, ainsi que les prix au moment de l’échec : avec ces quatre éléments, la plupart des refus d’ordre s’expliquent sans autre investigation. Les traces détaillées sont activables par un paramètre, ce qui évite d’inonder le journal en production. Enfin, ErrorDescription() provient du fichier d’en-tête stdlib.mqh livré avec MetaTrader 4. La signification de chaque code est développée dans la page GetLastError en MQL4.

Le débogueur de MetaEditor

Quand le journal ne suffit pas, par exemple pour comprendre pourquoi une condition n’est jamais vraie, le débogueur permet d’observer le programme de l’intérieur.

  1. Posez un point d’arrêt en double-cliquant dans la marge à gauche de la ligne voulue, ou avec F9.
  2. Lancez le débogage avec F5 : MetaEditor compile une version de débogage et l’attache à un graphique du terminal.
  3. Quand l’exécution s’arrête sur le point d’arrêt, observez les variables dans l’onglet de débogage de la boîte à outils. Ajoutez-y les expressions que vous voulez surveiller.
  4. Avancez pas à pas : F10 exécute la ligne sans entrer dans les fonctions appelées, F11 entre dans la fonction appelée.
  5. Arrêtez la session de débogage depuis la barre d’outils une fois l’analyse terminée.

La fonction DebugBreak() provoque un arrêt programmatique, utile pour s’arrêter uniquement dans une situation précise (par exemple quand un calcul renvoie une valeur négative). Elle n’a d’effet qu’en session de débogage et est ignorée dans une exécution normale.

Gardez à l’esprit qu’un point d’arrêt fige l’EA pendant que le marché continue : n’utilisez jamais le débogueur sur un compte réel.

Le testeur visuel, l’autre débogueur

Pour les problèmes liés à la logique de trading (entrée au mauvais moment, stop qui ne bouge pas), le mode visuel du testeur de stratégie est souvent plus parlant que le débogueur. Il rejoue l’historique bougie par bougie sur un graphique, avec les ordres dessinés et les messages de Comment() affichés. Vous pouvez ralentir la vitesse, mettre en pause et comparer ce que l’EA voit à ce que vous attendiez. La page Le Strategy Tester de MT4 détaille son utilisation.

Une méthode pour isoler un bug

  1. Reproduire. Identifiez une date et un symbole où le problème apparaît, idéalement dans le testeur, pour pouvoir le rejouer à volonté.
  2. Lire le journal en entier. Remontez au premier message anormal, pas au dernier : une erreur initiale en provoque souvent d’autres.
  3. Afficher les valeurs intermédiaires. Ajoutez des traces sur chaque élément de la condition qui pose problème. Une condition composée de cinq tests échoue souvent sur celui que l’on n’avait pas soupçonné.
  4. Réduire. Si le bug reste obscur, copiez la portion de code suspecte dans un script minimal. Un script s’exécute une fois, sans attendre de tick, et isole le calcul de tout le reste.
  5. Corriger, puis retester sur la même période pour vérifier que le symptôme a disparu, et sur une autre période pour vérifier que rien d’autre n’a changé.

Quand un écart apparaît entre le testeur et le compte réel, comparez les deux journaux ligne à ligne sur une même journée. Les différences viennent le plus souvent de l’exécution (spread, glissement, refus du serveur), de l’horloge utilisée ou d’un signal calculé sur la bougie en cours. Le journal enrichi décrit plus haut permet de trancher rapidement entre ces causes.

Pièges fréquents

  • Lire GetLastError() trop tard. Un appel réussi entre l’échec et la lecture ne remet pas le code à zéro, mais un autre échec l’écrase. Lisez le code immédiatement après l’opération. En MQL4, l’appel à GetLastError() remet en outre _LastError à zéro : stockez la valeur dans une variable locale, comme LogErreur() ci-dessus, avant de l’afficher ou de la tester plusieurs fois.
  • Saturer le journal. Un Print() à chaque tick produit des fichiers énormes sur un VPS et ralentit le testeur. Réservez les traces fréquentes au mode débogage.
  • Confondre journal du terminal et onglet Experts. Les messages de vos programmes vont dans l’onglet Experts ; l’onglet Journal du terminal contient surtout les événements de connexion et les opérations de trading.
  • Oublier la bougie 0. Beaucoup de « bugs » de signal viennent d’une lecture de Close[0], qui change pendant la bougie. Voir Tableaux de séries.

Et en MQL5 ?

Print(), PrintFormat(), Comment(), Alert() et DebugBreak() existent à l’identique en MQL5. MetaTrader 5 permet en plus de déboguer directement sur des données historiques dans le testeur. En revanche, stdlib.mqh et ErrorDescription() n’y sont pas fournis de la même façon : il faut écrire sa propre table de descriptions. Les autres différences sont listées dans la rubrique Migration de MQL4 vers MQL5.

FAQ

Où trouver les messages Print de mon EA ?

Dans l’onglet Experts de la fenêtre Terminal de MetaTrader 4, et dans les fichiers du dossier MQL4/Logs accessible par Fichier, Ouvrir le dossier des données. Dans le testeur, ils apparaissent dans l’onglet Journal.

Pourquoi mes points d’arrêt ne s’arrêtent-ils pas ?

Vérifiez que vous avez lancé le programme avec F5 depuis MetaEditor, et non en le glissant sur un graphique, et que la ligne concernée est bien exécutée : un point d’arrêt dans OnTick() n’est atteint qu’à l’arrivée d’une cotation.

Comment obtenir la description d’un code d’erreur ?

Incluez <stdlib.mqh> et appelez ErrorDescription(code), ou consultez la liste des codes dans la rubrique erreurs du site.

Comment éviter qu’un message apparaisse des milliers de fois ?

Conditionnez-le à un paramètre de débogage, ou ne l’écrivez qu’une fois par bougie en comparant Time[0] à la dernière heure mémorisée.

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.