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.
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 deCopyBuffer(). - 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 :
| Code | Constante | Signification officielle |
|---|---|---|
| 0 | ERR_SUCCESS | The operation completed successfully |
| 4003 | ERR_INVALID_PARAMETER | Wrong parameter when calling the system function |
| 4012 | ERR_INVALID_POINTER | Wrong pointer |
| 4752 | ERR_TRADE_DISABLED | Trading by Expert Advisors prohibited |
| 4753 | ERR_TRADE_POSITION_NOT_FOUND | Position not found |
| 4754 | ERR_TRADE_ORDER_NOT_FOUND | Order not found |
| 4756 | ERR_TRADE_SEND_FAILED | Trade request sending failed |
| 4758 | ERR_TRADE_CALC_FAILED | Failed to calculate profit or margin |
| 5052 | ERR_SMALL_ARRAY | Too 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) dansMqlTradeResult.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 renvoyerINIT_FAILEDavec 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.
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.
- Erreurs de compilation MQL5
- Invalid pointer access
- Codes de retour du serveur de trading
- 10004 Requote
- 10006 Requête rejetée
- 10013 Requête invalide
- 10014 Volume invalide
- 10015 Prix invalide
- 10016 Stops invalides
- 10017 Trading désactivé
- 10018 Marché fermé
- 10019 Fonds insuffisants
- 10021 Pas de cotations
- 10024 Trop de requêtes
- 10027 Trading automatique désactivé
- 10030 Mode de remplissage non supporté
- 4756 Échec d’envoi de la requête
- Array out of range
- Division par zéro
