MetaTrader 常见错误：MT4 与 MT5 错误代码、原因及服务器端修复

MetaTrader 如何报告错误

MetaTrader 以带编号的代码报告错误，这些代码具有由 MetaQuotes 文档规定的固定名称，编号可以告诉您请求在哪个环节失败。MT4 与 MT5 采用不同的编号体系，因此同一问题在不同平台上对应两个不同的代码。

在 MetaTrader 5 中，每个交易请求都会收到交易服务器的回复。MetaQuotes 对这一机制的描述如下：

"All requests to execute trade operations are sent as a structure of a trade request MqlTradeRequest using function OrderSend(). The function execution result is placed to structure MqlTradeResult, whose retcode field contains the trade server return code."
（译文：所有执行交易操作的请求均通过 OrderSend() 函数以交易请求结构 MqlTradeRequest 的形式发送。函数执行结果存放在 MqlTradeResult 结构中，其 retcode 字段包含交易服务器返回代码。）— MQL5 Reference, Trade Server Return Codes, MetaQuotes（访问于 2026年10月）

MT5 交易服务器返回代码的范围从 10004（TRADE_RETCODE_REQUOTE）到 10046（TRADE_RETCODE_HEDGE_PROHIBITED）。在 MetaTrader 4 中，同类信息来自 GetLastError()。与交易相关的代码位于低位区间（0–150，例如 130 ERR_INVALID_STOPS）。程序运行时错误从 4000 开始（例如 4109 ERR_TRADE_NOT_ALLOWED）。

成功代码并不等同于订单已成交。MQL5 参考文档中关于 OrderSend() 的说明提醒："OrderSend() 函数返回成功结果并不意味着订单已被执行"。它仅表示请求已被接受、等待进一步处理。当客户表示"显示 OK 但什么也没发生"时，请检查服务器日志。

查找真实错误代码的位置有三处：

• "日志"（Journal）选项卡（平台事件：连接、登录、订单请求）。
• "EA"（Experts）选项卡（由 EA 和脚本输出的消息，包括 GetLastError() 的结果）。
• 磁盘上的日志文件。MetaQuotes 的 MT5 帮助文档指出："平台日志文件存储在 Logs 目录中，EA 日志文件保存在 MQL5\Logs 中。文件名对应日志生成的日期——YYYYMMDD.LOG。"

内置日志查看器可按 "Full, No connection, Errors only"（全部、无连接、仅错误）筛选条目。

连接错误："No connection" 与 "Invalid account"

"No connection" 表示终端无法连接到其被分配的交易服务器地址；"Invalid account" 表示终端已连接到服务器，但服务器拒绝了该登录。两者需要进行不同的检查，而且经纪商能看到交易者看不到的信息。

交易者可以检查的内容

1. 在浏览器中确认网络连接正常。
2. 重新输入登录号、密码和准确的服务器名称。MT5 帮助文档指出，您也可以手动输入地址，格式为"[服务器编号]:[端口号]，例如 192.168.0.1:443"。
3. 确认所用密码为主密码。MetaQuotes 解释称："投资者授权允许您查看账户状态、分析价格并使用您自己的 EA，但不能交易。"
4. 检查代理和防火墙。在 MT5 中，"工具 > 选项"下的"服务器"选项卡包含"服务器连接设置、代理服务器配置"。
5. 打开日志查看器，按 "No connection" 筛选，并将 YYYYMMDD.LOG 文件发送给经纪商。

经纪商应在服务器端检查的内容

• 每个接入点的可达性。从您自身网络以外测试服务器列表中公布的每个地址和端口，并从多个地区进行测试。
• 近期的基础设施变更。新的 IP、DNS 记录、数据中心迁移或 DDoS 防护规则，常常引发成批的 "No connection" 问题。
• 服务器健康状况。交易服务器和接入服务器的 CPU、内存和磁盘。过载在完全断连之前会表现为超时（128 ERR_TRADE_TIMEOUT、10012 TRADE_RETCODE_TIMEOUT）。
• 账户状态。账户是否已启用？是否位于正确的组中？是否在迁移过程中被移动？是否开启了强制修改密码？MT5 帮助文档确认："强制修改密码可由交易服务器管理员启用。"
• 旧版客户端。5 ERR_OLD_VERSION（"Old version of the client terminal"，客户端终端版本过旧）表示终端需要更新。

更深层次的网络和主机问题，请参见外汇服务器故障排查和 MetaTrader 服务器托管。

MT4 错误代码及其 MT5 对应代码

MT4 交易错误使用较小的编号，由 MetaQuotes 列于 MQL4 Reference 中，其中大多数在 MT5 中有直接对应的代码。当客户在平台之间转换，或在 MT4 至 MT5 迁移期间同时运行两套服务器时，可使用下方的对照表。

该对照表是我们的实践指南，并非 MetaQuotes 官方表格。各项描述本身引自 MQL4 交易服务器返回代码页面。

交易线程繁忙（146）是 MT4 特有的错误。MQL4 函数 IsTradeContextBusy()"在交易线程被另一个 EA 占用时返回 true"。这是客户端问题：同一终端中的多个 EA 正在争用交易线程，解决方法是加入重试逻辑或减少每个终端运行的 EA 数量。经纪商无法在服务器端修复此问题。

自动交易与权限错误

自动交易错误可按名称清晰区分：10026 表示服务器禁用了自动交易，10027 表示客户终端禁用了自动交易。在 MT4 中，对应的客户端错误为运行时错误 4109。

插件也可能拦截或改写请求。拒绝订单的风控或路由插件，在客户端会表现为一般性拒绝（10006）或一般错误（2）。如果拒绝是在插件更新后开始出现的，请首先检查该插件。我们在 MetaTrader 插件开发服务中构建并维护此类插件。

从救火到监控

大多数反复出现的 MetaTrader 错误都可以在客户投诉之前于服务器日志中被发现。做到这一点的方法是关注错误率，而不是单个工单。某个交易品种上 10021 的增加、某个交易时段内的超时，或桥接重启后的拒单，在开始后几分钟内即可在日志中看到。

FXSUPPORT 为经纪商和自营交易公司提供 MT4/MT5 平台支持：搭建、更新、备份、配置、日志监控和桥接配置。我们还提供位于英国和荷兰的服务器基础设施，配备监控，正常运行时间目标为 99.9%。在实践中，这意味着我们会：

• 监控平台和桥接日志中的错误模式，而不仅仅是宕机；
• 在每次变更后以及夏令时切换前，审查交易品种、交易时段和组的设置；
• 在平台更新后检查插件的运行情况；
• 加固服务器以抵御 DDoS，并确保备份可恢复。

如果您经营一家经纪商，而您的支持团队每天都在回答相同的错误工单，这说明问题根源在服务器上。请参见 MT5 支持和 MT4 支持了解我们的服务范围，或联系我们申请免费技术评估。