MT5 錯誤代碼詳解:10027、10030、10016 等
MT5 / MQL5 錯誤代碼:回傳代碼 10004–10031 與執行階段錯誤
MT5 會回報兩類錯誤:5 位數的交易回傳代碼(例如 10027 自動交易遭停用、10030 不支援的成交方式、10016 無效停損、10019 資金不足),以及由 GetLastError() 回傳的 4 位數執行階段錯誤(例如 4401、4756)——下表列出每個代碼對應的解法。
速查表:代碼 → 含義 → 解法
編號與常數名稱皆以 MQL5 官方參考文件為準(交易伺服器回傳代碼與執行階段錯誤)。
交易回傳代碼(MqlTradeResult.retcode)
| 代碼 | 常數 | 含義 | 解法 | 詳情 |
|---|---|---|---|---|
| 10004 | TRADE_RETCODE_REQUOTE | 重新報價——成交前價格已變動 | 放寬允許的偏差(deviation),或以最新價格重新送出 | Off quotes 與重新報價 |
| 10006 | TRADE_RETCODE_REJECT | 請求遭拒絕 | 通常是點差過大或行情過快所致;讓 EA 在之後的 tick 重試即可 | — |
| 10013 | TRADE_RETCODE_INVALID | 無效的請求 | 請求中的某個欄位(動作、訂單類型、交易品種)有誤;送出前先用 OrderCheck() 驗證 | — |
| 10014 | TRADE_RETCODE_INVALID_VOLUME | 請求中的交易量無效 | 將手數依交易品種的最小值、最大值與級距(SYMBOL_VOLUME_MIN / MAX / STEP)取整 | — |
| 10015 | TRADE_RETCODE_INVALID_PRICE | 請求中的價格無效 | 依交易品種的小數位數與最小跳動單位將價格正規化;確認掛單位於市價的正確一側 | — |
| 10016 | TRADE_RETCODE_INVALID_STOPS | 請求中的停損停利無效 | 讓 SL/TP 的距離大於券商的停止位,並位於價格的正確一側 | Invalid stops |
| 10017 | TRADE_RETCODE_TRADE_DISABLED | 交易已停用 | 在規格中查看該品種的交易模式,並確認是以交易密碼(而非投資人密碼)登入;否則請洽詢券商 | — |
| 10018 | TRADE_RETCODE_MARKET_CLOSED | 市場已關閉 | 等待該品種的交易時段開啟 | Market closed |
| 10019 | TRADE_RETCODE_NO_MONEY | 資金不足,無法完成請求 | 縮小手數、平掉部分倉位或入金 | Not enough money |
| 10021 | TRADE_RETCODE_PRICE_OFF | 沒有可用於處理請求的報價 | 檢查連線以及該品種目前是否有報價,然後重試 | Off quotes 與重新報價 |
| 10026 | TRADE_RETCODE_SERVER_DISABLES_AT | 自動交易遭伺服器停用 | 券商封鎖了此帳戶的演算法交易;請聯絡券商 | 自動交易停用 |
| 10027 | TRADE_RETCODE_CLIENT_DISABLES_AT | 自動交易遭用戶端停用 | 開啟 Algo Trading 按鈕,並在選項與 EA 屬性中允許演算法交易 | 自動交易停用 |
| 10030 | TRADE_RETCODE_INVALID_FILL | 訂單成交方式無效 | 將 type_filling 設為該品種支援的方式(FOK / IOC / Return) | Unsupported filling mode |
| 10031 | TRADE_RETCODE_CONNECTION | 未與交易伺服器連線 | 檢查連線狀態列、VPS 網路以及券商的伺服器狀態 | — |
執行階段錯誤(GetLastError())
| 代碼 | 常數 | 含義 | 解法 | 詳情 |
|---|---|---|---|---|
| 4001 | ERR_INTERNAL_ERROR | 非預期的內部錯誤 | 並非對應單一原因:在要檢查的函式之前呼叫 ResetLastError(),若持續出現則重新啟動或更新終端 | — |
| 4401 | ERR_HISTORY_NOT_FOUND | 找不到請求的歷史紀錄 | 讀取之前,先以包含該成交或訂單的期間呼叫 HistorySelect() | — |
| 4752 | ERR_TRADE_DISABLED | 禁止 Expert Advisor 交易 | 開啟 Algo Trading,並在 EA 屬性中勾選「Allow Algo Trading」 | 自動交易停用 |
| 4756 | ERR_TRADE_SEND_FAILED | 交易請求送出失敗 | OrderSend() 回傳了 false;請讀取 MqlTradeResult.retcode 了解真正原因(常見為 10027、10030 或 10016) | — |
從 MT4 轉過來? 對於相同的情況,MT4 使用的是另一套編號,大多為 3 位數(134、130、132、136、4109 ……)。下文各小節皆列出取自 MQL4 官方參考文件的 MT4 對應代碼。請注意,在 MT5 中 4109 代表 ERR_CHART_WRONG_PROPERTY(圖表錯誤),而非交易錯誤。
本站3款主力EA(公開長期回測與前向測試的全部數據)
📧 免費電子郵件課程(共 8 封)+ 訂閱者專屬 MT5 指標 13 款合集
※ 嚴格保護隱私。可隨時取消訂閱。
如何查看 Expert 分頁
點擊 MT5 下方的 Expert 分頁,即可依時間順序查看所有 EA 的活動日誌。
顯示格式:
2026.05.18 10:00:01.234 GOLD VIPER XAUUSD,M30: [ERROR] 10016
時間 EA名稱 交易品種 時間週期 訊息內容
出現錯誤時,請根據代碼編號在上表中查找原因。
常見錯誤代碼與處理方法
10019 — 資金不足(TRADE_RETCODE_NO_MONEY)
MT4 對應代碼: 134 ERR_NOT_ENOUGH_MONEY。ERR_NO_MONEY 是對同一情況廣泛使用的簡稱。
訊息範例:"Order failed: not enough money"
"No money"
原因: 保證金不足,EA 無法建立新倉位。
處理方法:
- 在 MT5 的交易分頁確認當前保證金維持率
- 若維持率接近或低於 100%,考慮追加入金
- 調低 EA 的
RiskPercent設定以縮小倉位規模 - 手動平倉部分現有倉位,釋放保證金
📖 為何餘額看似充足卻仍然出現,以及用來預防的 MQL5 程式碼,請參閱 MT5 的 Not enough money — 原因與解法。
10027 — 自動交易遭用戶端停用(TRADE_RETCODE_CLIENT_DISABLES_AT)
相關的 MT5 執行階段錯誤: 4752 ERR_TRADE_DISABLED。MT4 對應代碼: 4109 ERR_TRADE_NOT_ALLOWED。
訊息範例:"AutoTrading disabled by client"
"Trade is not allowed"
原因: MT5 的自動交易功能已關閉。
處理方法:
- 點擊 MT5 工具列上的 Algo Trading 按鈕將其開啟(按鈕應變為綠色)
- 進入工具 → 選項 → Expert Advisors → 啟用 Allow Algo Trading,然後重新啟動 MT5
此錯誤常見於 VPS 重啟後 MT5 自動開啟時。
📖 完整的權限鏈(選項設定、各圖表的 Allow Algo Trading、投資人密碼,以及 10027 與 10026 的差異),請參閱 MT5 自動交易停用 — 徹底解決。
10018 — 市場已關閉(TRADE_RETCODE_MARKET_CLOSED)
MT4 對應代碼: 132 ERR_MARKET_CLOSED。
訊息範例:"Market closed"
原因: EA 試圖在非交易時段(週末或假日)進場。
處理方法: 無需處理。週末市場關閉,在此期間任何進場嘗試都會出現此錯誤;市場重新開盤後 EA 會自動恢復。
📖 平日也出現?交易品種的交易時段、伺服器時間與僅限平倉模式,詳見 Market closed(10018/132)— 原因與解法。
10016 — 無效停損(TRADE_RETCODE_INVALID_STOPS)
MT4 對應代碼: 130 ERR_INVALID_STOPS。
訊息範例:"Invalid stops"
原因: SL(停損)或 TP(止盈)的數值違反了券商的最小停止位要求。
處理方法:
- 確認券商的停止位(最小 SL 距離):在 MT5 中右鍵點擊交易品種 → 規格 → 查看停止位欄位
- 確保 EA 的 SL 距離大於停止位
- 此錯誤最常見於 ATR 值極小的低波動時段
📖 停止位的實際運作方式、10016 與 130 的差異,以及一勞永逸避免它的 MQL5 程式碼,請參閱 Invalid stops(10016/130)— 徹底解決。
10021 — 無報價(TRADE_RETCODE_PRICE_OFF)
MT4 對應代碼: 136 ERR_OFF_QUOTES。
訊息範例:"Off quotes"
原因: 未能從券商伺服器接收到報價,屬於連線問題。
處理方法:
- 在 MT5 畫面下方的狀態列確認連線狀態
- 若已斷線,請重新啟動 MT5
- 到券商的伺服器狀態頁面確認是否發生故障
- 確認 VPS 的網路連線
📖 與重新報價(10004/138)的差異、偏差(deviation)調整以及重試的實作方式,請參閱 Off quotes 與重新報價(10021/10004)— 徹底解決。
📖 剛更換券商就出現 Unsupported filling mode(10030)?那是另一個問題——請參閱 Unsupported filling mode(10030)— 解法。
10012 — 請求逾時(TRADE_RETCODE_TIMEOUT)
MT4 對應代碼: 128 ERR_TRADE_TIMEOUT。
訊息範例:"Request canceled by timeout"
原因: 因伺服器壅塞或網路延遲,訂單逾時。
處理方法:
- 此錯誤最常見於重大新聞發布後伺服器負載較高的時段
- EA 通常會在下一個 tick 重試——無需處理
- 若頻繁發生,請檢視 VPS 的網路環境或考慮更換券商
10006 — 請求遭拒絕(TRADE_RETCODE_REJECT)
訊息範例:"Request rejected"
原因: 訂單遭券商拒絕——通常是因為點差超出限制或價格變動過快。
處理方法:
- 檢查
MaxSpreadPoints設定;點差大幅擴大時此錯誤較為常見 - 在新聞發布期間及發布後不久,這屬於預期行為——可以忽略
- 若頻繁發生,可適度調高
MaxSpreadPoints的值
"Margin level too low"
訊息範例:"Margin level too low. Skip signal."
原因: EA 的 UseMarginCheck = true 設定偵測到保證金維持率已低於 MinMarginLevel(例如 200%),因此自動阻擋新的進場。
處理方法:
- 這是正常的保護機制——並非錯誤
- 保證金維持率回升後,進場將自動恢復
- 根本解決方式:追加入金或調低
RiskPercent
"No signal on this bar" 或 "Wait for next bar"
這些不是錯誤,而是除錯日誌。
"No signal. ATR=1245, EMA(50)=1998.23"
EA 會在每根 K 線上評估圖表,並在不符合進場條件時輸出日誌。這屬於正常運作。
錯誤優先度分類
| 優先度 | 錯誤 | 對應方式 |
|---|---|---|
| 緊急 | 10019 資金不足(MT4:134) | 立即入金或縮小手數 |
| 緊急 | 10027 自動交易停用 / 4752(MT4:4109) | 開啟 Algo Trading |
| 注意 | 10016 無效停損(MT4:130) | 重新檢視 SL 設定 |
| 注意 | 10030 成交方式無效 | 設定該品種支援的成交方式 |
| 注意 | 10021 無報價(MT4:136)反覆出現 | 確認連線狀況 |
| 正常 | 10018 市場已關閉(MT4:132)僅限週末 | 無需處理 |
| 正常 | 10012 逾時(MT4:128)偶發 | 無需處理 |
| 正常 | Margin level too low | 保證金偏低時的正常保護行為 |
如何有效率地查閱 Expert 分頁日誌
篩選日誌
在 Expert 分頁內按右鍵並選擇篩選,即可只顯示特定 EA 或特定錯誤類型的日誌。
日誌檔案的儲存位置
MT5 的日誌檔案儲存於以下路徑:
C:\Users\[使用者名稱]\AppData\Roaming\MetaQuotes\Terminal\[ID]\MQL5\Logs\
檔案會依日期自動產生。排查錯誤時,請開啟此資料夾。
總結
EA 的錯誤大多可歸納為以下四大類型:
- 保證金不足(10019) — 追加入金或縮小手數
- 自動交易已關閉(10027 / 4752) — 點擊 Algo Trading 按鈕將其開啟
- 連線問題(10021 / 10031) — 重新啟動 MT5 或確認 VPS 網路
- 正常行為 — 無需處理(週末休市、迴避點差擴大等)
養成每天查看 Expert 分頁的習慣,以便在緊急錯誤(10019 與 10027)造成問題之前及早發現。
常見問題
Q:錯誤代碼可以在哪裡查詢?
MQL5 官方參考文件列出了所有代碼:10004–10046 範圍請見交易伺服器回傳代碼,4xxx 範圍請見執行階段錯誤。也可透過 MT5 的內建說明(按 F1 鍵)進行搜尋。
Q:回傳代碼(retcode)與 GetLastError() 有什麼不同?
回傳代碼(10004–10046)是交易伺服器對訂單的回覆,儲存在 MqlTradeResult.retcode 中。GetLastError() 回傳的則是 MQL5 程式本身的執行階段錯誤(4xxx 與 5xxx)。當 OrderSend() 失敗時,往往兩者都會出現:GetLastError() 回傳 4756,另外還有一個說明實際原因的回傳代碼。
Q:錯誤頻繁出現時,應該停止 EA 嗎?
若 10018(市場已關閉)或 10012(逾時)只是偶爾出現,無需停止 EA。但若 10019(資金不足)反覆出現,請暫停 EA,檢視保證金狀況,問題解決後再重新啟動。
Q:出現「Invalid account」錯誤。
MT5 的登入資訊(伺服器名稱、登入 ID 或密碼)可能有誤。請透過檔案 → 開設帳戶重新登入。
Q:沒有顯示任何錯誤,但 EA 就是不進場。
如果既沒有錯誤也沒有進場,表示 EA 只是在等待進場條件成立——這完全正常。EA 並非在每根 K 線都會進場,只有在所有條件同時符合時才會進場。請耐心等待一段時間。H1 的 EA 一天進場 1 到 3 次即屬正常運作。
相關文章
📧 免費電子郵件課程(共 8 封)+ 訂閱者專屬 MT5 指標 13 款合集
※ 嚴格保護隱私。可隨時取消訂閱。