MQL5エラーコード辞典｜GetLastError・TRADE_RETCODE・コンパイルエラー一覧

MT5 / MQL5でEA、インジケーター、外部連携、バックテスト、開発作業を行っていると、ランタイムエラー、取引サーバーリターンコード、コンパイルエラー、WebRequest関連エラー、Strategy Tester関連エラーなどが表示されることがあります。

エラーを確認する時に重要なのは、コード番号やメッセージだけで原因を断定しないことです。エラーが出た場所、発生時刻、EA名、インジケーター名、銘柄名、時間足、setファイル、Expertsログ、Journalログ、MetaEditorのエラー欄を合わせて確認します。

この記事では、MQL5のGetLastError系ランタイムエラー、MqlTradeResult.retcodeで返るTRADE_RETCODE系リターンコード、MetaEditorのコンパイルエラー、WebRequest / HTTP / Webhook / Google Sheets / Discord通知関連エラー、Strategy Tester関連エラーを辞書形式で整理します。

注意：このページは、MT5 / MQL5のエラーコードやエラーメッセージを確認するための技術確認記事です。投資判断、売買タイミング、利益保証、勝率保証、損失回避保証、推奨ロット、推奨銘柄、特定ブローカーへの誘導を目的とした内容ではありません。

MT5 / MQL5のエラーコードは種類を分けて確認する

MT5 / MQL5のエラーは、すべて同じ場所に表示されるわけではありません。まず、どの種類のエラーかを分けて確認します。

ランタイムエラー

ランタイムエラーは、MQL5プログラムの実行中に発生するエラーです。GetLastError()で直近のエラーコードを確認することがあります。

ランタイムエラーは、関数の引数不備、ハンドル不正、ファイル操作失敗、配列範囲外、WebRequest失敗、履歴データ不足など、さまざまな場面で発生します。

取引サーバーリターンコード

取引サーバーリターンコードは、OrderSendなどの注文処理に対してサーバー側から返される結果です。MqlTradeResult.retcodeに格納されるため、EAの注文処理や決済処理を確認する時に重要です。

TRADE_RETCODE系は、正常完了を示すものもあれば、注文条件不備、自動売買無効、価格変化、証拠金不足、取引時間外、ポジション制約を示すものもあります。

コンパイルエラー

コンパイルエラーは、MetaEditorでmq5やmqhをコンパイルした時に表示されます。

コンパイルエラーはMT5上の運用ログではなく、ソースコード作成・改修時のエラーです。行番号だけでなく、前後の構文、include、文字コード、直前に変更した箇所を確認します。

外部連携エラー

外部連携エラーは、Discord通知、Google Sheets連携、Webhook、API通信、外部認証などで発生することがあります。

外部連携エラーが出ていても、EA本体の判定や表示は動いている場合があります。売買条件、通知条件、WebRequest通信、外部サービス側の権限は分けて確認します。

バックテスト関連エラー

バックテスト関連エラーでは、EAファイル、テスト期間、銘柄、時間足、ヒストリカルデータ、spread条件、setファイル、外部連携制約を確認します。

バックテスト結果や最適化結果は将来の結果を保証するものではありません。結果だけでなく、検証条件とログを残してください。

GetLastErrorとTRADE_RETCODEを混同しない

MQL5のエラー確認では、GetLastErrorで確認する実行時エラーと、MqlTradeResult.retcodeで確認する取引サーバーリターンコードを分けて確認します。

GetLastErrorは、MQL5プログラム実行中の関数呼び出しや端末側処理に関するエラー確認で使います。一方、TRADE_RETCODE系は、OrderSendなどの取引リクエストに対して、取引サーバー側から返される結果コードです。

エラーコードだけで原因を断定せず、発生した関数、対象銘柄、時間足、EA名、バージョン、Expertsログ、Journalログ、MetaEditorのエラー欄を合わせて確認してください。

エラーコードを見る前に確認する場所

GetLastErrorで確認するMQL5ランタイムエラー一覧

ここでは、GetLastError()で確認するMQL5ランタイムエラーを、実務で確認しやすいカテゴリ別に整理します。コード番号や定数名は原因特定の入口であり、必ず発生箇所、ログ、直前の処理と合わせて確認してください。

共通・内部・パラメータ関連エラー

チャート・オブジェクト関連エラー

マーケット・ヒストリー関連エラー

通知・端末・FTP関連エラー

取引・口座・プロパティ関連エラー

インジケーター・バッファ関連エラー

ファイル・ディレクトリ関連エラー

文字列・配列関連エラー

WebRequest・ネットワーク関連エラー

取引サーバーリターンコード一覧｜TRADE_RETCODE系

TRADE_RETCODE系は、注文や決済のリクエストに対して取引サーバーから返る結果です。正常系のコードも含まれるため、コードが出たからといってすべてがエラーとは限りません。

注文成功・処理完了を示すコード

注文条件不備を示すコード

ロット・証拠金・価格に関するコード

自動売買許可・取引権限に関するコード

サーバー・市場状態に関するコード

ポジション・決済制約に関するコード

MetaEditorのコンパイルエラー一覧

MetaEditorのコンパイルエラーは、数値コードよりも表示メッセージ、対象ファイル、行番号、列番号を見て確認します。表示行だけでなく、直前の行や前後の括弧不整合が原因になることがあります。

WebRequest・Webhook・Google Sheets連携のエラー一覧

WebRequest確認の補足：WebRequestを使う場合は、MT5の「オプション」→「エキスパートアドバイザ」タブで、通信先URLを許可リストへ追加する必要があります。また、WebRequestはインジケーターからは呼び出せず、Strategy Testerでも実行できません。EA本体の判定、通知処理、外部通信処理は分けて確認してください。

バックテスト・ストラテジーテスター関連エラー一覧

エラー別に最初に見るログ

EA利用者向けの確認ポイント

EA利用者がMQL5コードを直接確認しない場合でも、エラー調査で整理できる情報があります。

MQL5開発者向けの確認ポイント

MQL5開発者は、エラーコードを出すだけでなく、どの責務で失敗したかをログで分けると調査しやすくなります。

特に注文エラーでは、signalが成立したか、EA側が発注を止めたのか、OrderSendを実行したのか、取引サーバーが拒否したのかを分けて記録します。

問い合わせ前に整理する情報

開発依頼前の資料整理は、次のページも参考にしてください。

MT5開発依頼前に用意する資料まとめ

送ってはいけない情報

エラー確認では、ログやスクリーンショットが重要です。ただし、以下の情報はそのまま送らないでください。

• 口座番号の全桁
• 投資家パスワード
• マスターパスワード
• Webhook URLの実値
• GAS URLの実値
• APIキー
• 認証トークン
• 個人情報
• 未加工の口座履歴画像
• 第三者の個人情報が入ったログ
• 顧客情報や販売先情報
• 実運用成績の詳細データ

ログを送る場合は、必要な箇所を残しつつ、口座番号、URL、APIキー、トークン、個人情報をマスクしてください。

MT5 / MQL5エラー確認チェック表

• □ エラーが出た場所を確認した
• □ エラーコードまたは定数名を控えた
• □ エラーメッセージ全文を控えた
• □ Expertsログを確認した
• □ Journalログを確認した
• □ MetaEditorのエラー欄を確認した
• □ 発生時刻を記録した
• □ EA名・インジ名・バージョンを記録した
• □ 銘柄名、時間足、口座種別を記録した
• □ 使用したsetファイルを保存した
• □ 直前に変更した設定を整理した
• □ スクリーンショットを保存した
• □ Webhook URLやAPIキーをマスクした
• □ 口座番号や個人情報を隠した
• □ 同じエラーが再現するか確認した
• □ GetLastError系かTRADE_RETCODE系かを分けて確認した
• □ Order / Position / Deal / Historyのどこで発生したかを確認した

次に読む技術講座

この講座とあわせて確認すると、MT5・MQL5開発、検証、不具合調査の流れを整理しやすくなります。

次に確認するページ

FAQ

この辞典だけでMQL5の仕様をすべて判断できますか？

いいえ。この辞典は、MQL5のエラーコードやエラーメッセージを実務上確認しやすく整理した記事です。最終的な仕様確認は、公式リファレンス、MetaEditorのコンパイル結果、Expertsログ、Journalログ、実際の動作結果を合わせて確認してください。

公式リファレンスとこの記事は何が違いますか？

公式リファレンスは、エラーコードや定数の仕様確認に向いています。この記事では、EA開発や不具合調査で見落としやすい「出る場面」「最初に確認すること」「関連ログ」「問い合わせ前に整理する情報」を中心に補足しています。

エラーコードだけで原因を断定できますか？

断定できない場合があります。エラーコードは原因確認の入口です。実際には、発生関数、対象銘柄、時間足、入力値、Expertsログ、Journalログ、MetaEditorのエラー欄、取引サーバー応答を合わせて確認する必要があります。

EA利用者でも確認すべき項目はありますか？

あります。EA名、バージョン、発生日時、銘柄、時間足、Expertsログ、Journalログ、スクリーンショット、setファイル、エラー前後の操作を整理しておくと、原因確認が早くなります。

開発依頼前にどの情報を整理すればよいですか？

EA名、バージョン、対象銘柄、時間足、発生日時、エラーコード、エラーメッセージ、Expertsログ、Journalログ、MetaEditorエラー欄、setファイル、再現手順、スクリーンショットを整理してください。Webhook URL、APIキー、認証トークン、口座番号などは必ずマスクしてください。

ExpertsログとJournalログのどちらを確認すべきですか？

両方確認するのが基本です。ExpertsログではEAやインジケーター内部の処理、GetLastError、retcode、判定ログを確認できます。Journalログでは端末側、注文送信、接続状態、Strategy Tester、サーバー応答に関する補足情報を確認できます。

WebRequest関連エラーでは何を確認すべきですか？

WebRequest許可URL、送信先URLの形式、HTTPステータス、payload、timeout、外部サービス側の権限、VPS通信状態を確認します。ただし、Webhook URL、GAS URL、APIキー、認証トークンの実値は公開ログや問い合わせ文に含めないでください。

TRADE_RETCODE_INVALID_FILLが出た場合は何を確認すべきですか？

銘柄が対応しているfilling modeと、EA側で指定しているtype_fillingを確認します。SymbolInfoIntegerでSYMBOL_FILLING_MODEを確認し、ORDER_FILLING_FOK、ORDER_FILLING_IOC、ORDER_FILLING_RETURNのどれが使えるかを確認してください。

unknown symbol 0xFEFFとは何ですか？

UTF-8 BOMや不可視文字がソースコードに混入している時に出ることがあります。特にファイル先頭やコピペ直後に発生しやすいため、UTF-8 BOMなしで保存し直す、不可視文字を削除する、該当ファイルの先頭行を確認する、といった対応が必要です。

この記事にない項目はどのように確認すればよいですか？

まず公式リファレンス、MetaEditorのコンパイル結果、Expertsログ、Journalログ、取引タブ、履歴タブ、Strategy Testerログを確認してください。EA固有の仕様が関係する場合は、対象ファイル、バージョン、設定値、再現手順、ログを整理して確認すると原因を追いやすくなります。

開発依頼・不具合調査前の確認：エラーが出た場合は、コード番号だけで判断せず、GetLastError系かTRADE_RETCODE系か、コンパイルエラーか、WebRequest/HTTP系か、Strategy Tester関連かを先に分けてください。そのうえで、Expertsログ、Journalログ、MetaEditorエラー欄、発生時刻、EA名、銘柄、時間足、setファイル、再現手順を整理してください。

MT5開発依頼前に用意する資料まとめ

関連するMQL5技術辞典

MQL5のエラーを確認する時は、エラーコードだけでなく、どの関数・取引処理・時系列取得・ファイル操作・外部連携で発生しているかを分けて確認することが重要です。

関連するMQL5技術辞典もあわせて確認してください。

確認ポイント：エラー確認では、GetLastErrorだけで原因を断定せず、関数の戻り値、TRADE_RETCODE、Expertsログ、Journalログ、対象symbol、timeframe、ticket、magic、buffer番号、HTTPステータスなどを合わせて確認してください。

まとめ

MQL5のエラー確認では、コード番号だけではなく、エラーの種類と発生場所を分けることが重要です。

GetLastError系ランタイムエラー、TRADE_RETCODE系取引リターンコード、MetaEditorコンパイルエラー、WebRequest/HTTP系エラー、Strategy Tester関連エラーは、それぞれ確認場所と原因の切り分け方が異なります。

不具合調査や開発依頼を行う場合は、Expertsログ、Journalログ、MetaEditorエラー欄、発生時刻、EA名、バージョン、銘柄、時間足、setファイル、再現手順を整理してください。APIキー、認証トークン、Webhook URL、口座番号などの機密情報は、必ずマスクして扱ってください。