风险提示:本文为软件开发与技术服务类技术文章,仅用于MQL5程序化开发的技术交流与软件工程实践探讨。文中涉及的单元测试框架设计、依赖注入与Mock对象、交易结果码分支验证等内容,均为软件工程原理演示与教学用途,不构成任何投资建议、交易策略推荐或收益预期。外汇、贵金属、CFD等杠杆交易存在较高风险,可能导致重大本金损失。文中代码片段仅供学习参考,未经完整工程化封装,需经人工审查、编译测试与充分的模拟盘验证后方可使用,直接投入实盘可能造成资金损失。单元测试通过不代表策略有效,也不代表实盘不会亏损。本网站仅提供软件开发技术服务,不涉及任何交易平台运营、经纪业务或投资咨询业务。
回测跑得顺、上线就乱,问题常常不在策略本身,而在测试的方式。策略逻辑和交易执行缠在一个函数里,你能测的就只剩“整条链路跑一遍”,而链路上每一环都要靠真实服务器配合——服务器不会专门为你制造一次部分成交,不会在第三次重试时恰好返回超时,也不会在余额刚好卡住时停下。单元测试要解决的正是这件事:把交易执行换成一个按剧本说话的替身,让策略在没有网络、没有持仓、没有真实账户的情况下,把每一个分支都走一遍。这篇从零搭一套不依赖任何外部库的测试框架,用接口隔离下单,用Mock制造各种服务器返回码,最后讲清楚测试脚本怎么跑、分支清单怎么列。
一、“回测猛如虎,实盘二百五”:盲区出在耦合上
回测里的下单走的是测试器内部的模拟服务器,滑点、成交、拒单都按测试器的建模方式简化处理。你能调的是行情区间和参数,调不了的是服务器的返回。所以回测能回答“这套规则在给定行情下赚不赚”,回答不了“服务器返回一个意外结果时,代码会不会算错”。
强耦合的写法很常见:策略类里直接实例化一个CTrade,判断信号、算手数、发单、改止损全塞在一个函数里。这时候想验证“部分成交之后仓位算得对不对”,常规做法只能是等真实服务器真的给你一次部分成交——不可控、不可重复、也没法回放。更麻烦的是,这种验证只能靠观察结果,你分不清是信号算错了还是订单执行那一步错了。
单元测试要回答的问题很小:给定一个结果码和一个成交量,逻辑分支走对了没有。输入可控,输出可断言,一次失败可以稳定复现。三条回测基本覆盖不到的分支值得单独提出来——部分成交后的仓位重算、重试的幂等性、余额不足时的降级路径。它们都不报错,只会让持仓量悄悄偏离预期。
重点提示:判断一段逻辑该不该写单元测试,标准很直接:它的输入里有没有你控制不了的外部状态。有,就把那部分换成可控的替身。EA里最典型的外部状态就是交易服务器的返回——结果码、成交量、成交价,全都由服务器决定,本地代码只能接受和判断。把这层替身化之后,剩下的纯逻辑才好测。
二、第一步:搭一个不依赖外部库的测试基类
最小可用的测试框架只需要三样东西:一个统一的用例入口、几个断言方法、一份通过失败统计。MQL5没有现成的测试库,但语言本身够用——抽象类、纯虚函数、虚函数分发都在,几十行就能立起来。
// 测试用例基类:断言 + 计数,不依赖任何外部库
class CTestCase
{
protected:
string m_name;
int m_pass;
int m_fail;
public:
CTestCase(const string name): m_name(name), m_pass(0), m_fail(0) {}
virtual void Run() = 0; // 纯虚:派生类必须实现
void AssertTrue(const bool cond, const string msg)
{
if(cond) { m_pass++; return; }
m_fail++; // 不中断,继续跑后面的断言
PrintFormat("[FAIL] %s :: %s", m_name, msg);
}
void AssertNear(const double actual, const double expect,
const double eps, const string msg)
{
AssertTrue(MathAbs(actual - expect) <= eps,
StringFormat("%s (actual=%s expect=%s)", msg,
DoubleToString(actual, 2), DoubleToString(expect, 2)));
}
int Passed() const { return(m_pass); }
int Failed() const { return(m_fail); }
string Name() const { return(m_name); }
};
三处设计是刻意的。Run()声明成纯虚函数,派生类漏写就编译不过,不会出现“以为测了、其实没测”这种最坏情况。断言失败只记账不中断,因为MQL5没有try/catch,一个用例里第一个断言失败就返回,后面的分支永远跑不到,一次跑完能看到全部问题才有意义。AssertNear单独留一个,是因为手数和价格都是浮点数,直接比相等永远不可靠。
知识点:纯虚函数在MQL5里用 = 0 或 = NULL 声明,从build 1295起支持。一个类只要含纯虚函数就是抽象类,不能实例化,只能当基类——这正好是测试用例想要的行为。用 CTestCase *cases[] 存指针、循环调 cases[i].Run(),走的就是虚函数分发。
三、核心技巧:用接口把OrderSend摘出去
这里有一个必须先说清的细节。CTrade::OrderSend() 返回的是bool,这个bool为true只代表请求被服务器接受了,不代表成交量等于请求量。真实结果要去 ResultRetcode() 和 ResultVolume() 里取,它们对应MqlTradeResult结构的retcode与volume字段。所以Mock要伪造的是MqlTradeResult,不是函数返回值。这一点搞反,整套测试就是在验证一个假的东西。
// 执行接口:策略只认这一层,不认 CTrade
class ITradeExecutor
{
public:
virtual bool Send(const double vol, const ENUM_ORDER_TYPE type,
const double price, MqlTradeResult &res) = 0;
};
// Mock:按剧本返回结果码,不发真实请求
class CMockTradeExecutor : public ITradeExecutor
{
private:
uint m_codes[];
double m_fillRatio;
int m_calls;
public:
CMockTradeExecutor(const double ratio = 1.0): m_fillRatio(ratio), m_calls(0) {}
void Push(const uint code) { int n = ArraySize(m_codes); ArrayResize(m_codes, n + 1); m_codes[n] = code; }
int Calls() const { return(m_calls); }
virtual bool Send(const double vol, const ENUM_ORDER_TYPE type,
const double price, MqlTradeResult &res)
{
res.retcode = (m_calls < ArraySize(m_codes)) ? m_codes[m_calls] : TRADE_RETCODE_DONE;
res.volume = (res.retcode == TRADE_RETCODE_DONE_PARTIAL) ? vol * m_fillRatio : vol;
m_calls++;
return(res.retcode == TRADE_RETCODE_DONE || res.retcode == TRADE_RETCODE_DONE_PARTIAL);
}
};
接口只有一行签名,但它决定了策略能看见什么。策略只调Send(),拿回一个MqlTradeResult,至于这个结果来自真实服务器还是Mock,策略不知道也不需要知道。生产代码注入真实执行器,测试代码注入Mock,被测函数一行都不用改。
真实执行器也就十来行,成员放一个CTrade实例,Send()里调一次开仓,把结果结构体原样交回去。这里有一处极易写错:结果码要从Result()取,不是从开仓函数的返回值取。CTrade的开仓方法返回bool,这个bool为true只代表请求被服务器接受了,真正的结果码在Result()返回的MqlTradeResult里——把bool当结果码用,部分成交和完全成交在策略眼里就没有区别了。
// 生产实现:把CTrade包在接口后面,策略代码一行不用改
class CLiveTradeExecutor : public ITradeExecutor
{
private:
CTrade m_trade;
public:
virtual bool Send(const double vol, const ENUM_ORDER_TYPE type,
const double price, MqlTradeResult &res)
{
bool accepted = m_trade.PositionOpen(_Symbol, type, vol, price, 0.0, 0.0, NULL);
res = m_trade.Result(); // 结果码在这里,不在accepted里
return(accepted);
}
};
把两段放在一起看,接口的价值就出来了:OpenWithRetry()的签名里没有CTrade、没有_Symbol、没有任何交易库类型,只有接口指针和数值。它能在Mock上跑,也能在真实执行器上跑,跑的逻辑是同一份——这才是可测试的前提。
| 结果码 | 常量 | 含义要点 | Mock怎么配 | 策略侧应有反应 |
|---|---|---|---|---|
| 10009 | TRADE_RETCODE_DONE | 请求已完成 | volume = 请求量 | 累加成交量,结束 |
| 10008 | TRADE_RETCODE_PLACED | 挂单已被接受,尚未成交 | volume = 0 | 不累加持仓,等成交事件 |
| 10010 | TRADE_RETCODE_DONE_PARTIAL | 仅部分完成 | volume = 请求量 × 比例 | 累加实际量,按差额补单 |
| 10004 | TRADE_RETCODE_REQUOTE | 报价已变 | volume = 0 | 刷新价格后重发,计入重试上限 |
| 10019 | TRADE_RETCODE_NO_MONEY | 可用资金不足 | volume = 0 | 不重试,降量或中止 |
| 10016 | TRADE_RETCODE_INVALID_STOPS | 止损止盈无效 | volume = 0 | 不重试,按stops level重算 |
| 10014 | TRADE_RETCODE_INVALID_VOLUME | 手数无效 | volume = 0 | 不重试,按step与最小手数重算 |
风险提示:结果码是交易服务器给出的,不是本地校验出来的。同一份代码在不同经纪商的填充政策(FOK、IOC、Return)下,返回的码可能不同,测试通过不等于处处通过。10008 PLACED只表示挂单已被接受,订单还没有成交,把它当成“成交完成”去累加仓位,持仓量从第一笔就错了。Mock里必须显式区分这两种情况,否则测试会把错误当成正确固化下来。
操作参考:先写Mock,再写策略。Mock相当于给交易接口定合同:它规定策略能拿到哪些字段、哪些字段在什么情况下可能为零。写不出Mock,通常说明接口切得不对——策略还在依赖某个具体实现,而不是依赖一层抽象。这个顺序颠倒过来,往往是先写了一堆耦合代码,再想办法给它套测试,成本高得多。
四、实战:测“部分成交”与“重试幂等”
场景很简单:目标建仓1.00手,示例里让第一次只成交0.40手,剩下0.60要补。看起来再发一次就行,实际有三个地方会错。
第一是剩余量的算法。常见写法是“上次请求量减本次成交量”,但请求量本身可能已经被规整过,两次规整的舍入误差会累积。正确写法是“目标量减累计成交量”,每次都用累计值重算,误差不累积。第二是手数规整。补单前必须按SYMBOL_VOLUME_STEP规整,并判断剩余量是否还够SYMBOL_VOLUME_MIN,不够就不补,否则第二次请求会直接吃一个10014。这里还有个浮点坑:0.60除以0.01在双精度下是59.999…,直接取整会得到59,规整后变成0.59,凭空多补一次单。第三是哪些码该重试。部分成交、报价变动、超时可以重试;拒单、资金不足、无效止损、无效手数重试多少次结果都一样,属于硬失败,应当直接退出。
// 被测逻辑:剩余量按“目标 − 累计成交”算,不按“上次请求 − 本次成交”
double OpenWithRetry(ITradeExecutor *exec, const double target, const double price)
{
double step = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_STEP); // 手数步长
double minV = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MIN); // 最小手数
double filled = 0.0; MqlTradeResult res;
for(int i = 0; i < 3; i++)
{
double remain = target - filled;
remain = MathFloor(remain / step + 0.0000001) * step; // 加极小量规避浮点误差
if(remain < minV) break; // 不足最小手数,停止补单
if(!exec.Send(remain, ORDER_TYPE_BUY, price, res)) break; // 硬失败不重试
filled += res.volume; // 以服务器确认量为准
}
return(filled);
}
// 用例:第一次成交0.40手,第二次补齐
class CPartialFillTest : public CTestCase
{
public:
CPartialFillTest(): CTestCase("partial_fill") {}
virtual void Run()
{
CMockTradeExecutor mock(0.4);
mock.Push(TRADE_RETCODE_DONE_PARTIAL); mock.Push(TRADE_RETCODE_DONE);
AssertNear(OpenWithRetry(&mock, 1.00, 1.10000), 1.00, 1e-6, "补单后总量应等于目标");
AssertTrue(mock.Calls() == 2, "部分成交后只应补一次");
}
};
两行断言验的是两件事。AssertNear验最终成交量等于目标量,这是结果正确;AssertTrue验请求次数等于2,这是过程正确。只验第一条不够——同样的1.00手,可能是两次请求补出来的,也可能是五次请求一点点凑出来的。前者说明补单精准,后者说明每次都在丢量,实盘里多出来的手续费和滑点会把过程错误变成真实的资金损耗。
风险提示:重试必须有次数上限和间隔,而且上限要按“同一笔建仓意图”计,不是按“每次函数调用”计。补单逻辑一旦被OnTick反复触发,无上限的重试会在一根K线内连续发出多次请求,触发服务器的请求频率限制(10024 TRADE_RETCODE_TOO_MANY_REQUESTS),问题就从“成交不足”变成“被限流”。这一点在Mock里也要测:连续触发两次入口函数,断言总请求次数没有翻倍。
进阶思考:幂等性在交易代码里常被理解成“重复调用不出错”,实际上更难的是“重复调用不产生额外副作用”。测试它不能只看最终状态,必须同时断言调用次数和每次请求的参数。做法是让Mock把收到的每次请求都存进数组,用例结束时比对整条请求序列,而不是只比对最后一笔——序列一致,才说明过程可重放。
五、从单个用例到一键跑全量
用例写完,最后一步是能一次跑完。MQL5里跑测试用Script:入口是OnStart(),挂在任意一个图表上执行一次就退出。这里有个容易混淆的点——不存在“不挂图表独立运行的Script”,不绑定图表的是Service(服务),那是另一类程序,入口同样是OnStart(),但可以长期运行且没有图表上下文。跑测试用Script就够了,随便挂个空图表,不需要该品种有持仓,也不需要实时行情。
还有一个隐式依赖要拆掉。代码里用 _Symbol 取手数步长、最小手数、止损距离,在Script里拿到的是“当前所挂图表”的品种参数。这意味着同一份测试换一个图表跑,结果可能不同。测试用例依赖的品种参数应当显式传入,或者用固定常量注入,不要隐式读 _Symbol——测试最怕的就是换个环境结论就变。
知识点:三类MQL5程序的入口不同。EA由OnTick()等事件驱动,随图表加载卸载;Script在OnStart()执行一次后自动卸载;Service的OnStart()在独立线程长期运行,没有图表上下文。Script的执行环境绑在图表上,所以 SymbolInfoDouble(_Symbol, ...) 在Script里取的是图表品种的参数,这也是上面那个隐式依赖的来源。
| 分支 | 用哪个码触发 | 断言什么 |
|---|---|---|
| 全量成交 | 10009 | 累计成交等于目标量;请求次数为1 |
| 部分成交补单 | 10010 后接 10009 | 总量等于目标;请求次数为2 |
| 挂单已接受 | 10008 | 持仓不变;不进入补单路径 |
| 报价变动 | 10004 | 重试计数加一;超上限即退出 |
| 资金不足 | 10019 | 请求次数为1,不重试 |
| 手数规整 | 目标量取非step整数倍 | 每次请求量都是step的整数倍 |
覆盖率这件事,MQL5没有内置的行覆盖率工具,不必假装有。可行的做法是按分支列清单:把交易路径上可能的结果码列出来,每个码对应一条断言,跑完看哪条清单项还是空的。清单比百分比更实用——它直接告诉你哪个分支从来没被测过,而百分比只告诉你一个数字。
操作参考:清单按“会不会导致仓位算错”排序,先测部分成交、挂单已接受、无效手数这三条。它们的共同点是不报错,只让持仓量悄悄偏离预期,属于实盘里最难查的一类问题——日志干净,账户却对不上。把这三条测通,再考虑止损距离、滑点容忍度这些外围分支。
单元测试不是让EA变可靠的通用解法,它只解决一件事:把不可控的外部返回变成可控的输入,让逻辑分支在上线前被走过一遍。回测回答“这套规则在历史上赚不赚”,单元测试回答“服务器不按预期返回时,代码会不会算错”。两个问题不同,工具也不同。写得多了会发现它真正的价值不在抓Bug,而在改代码时的底气——重构完跑一遍,绿的就是绿的,不用靠回忆和运气。
进阶思考:框架本身也需要克制。测试基类只放断言和计数,不要往里塞日志落库、报告生成、参数读取——基类一旦变重,每个用例都被迫承担它不需要的依赖,最后测试跑不起来的原因是框架,不是被测代码。测试基础设施的首要原则是可抛弃:它服务于验证,不服务于长期架构。
风险提示:本文内容仅供软件开发与技术学习参考,不构成任何投资建议或交易指导。程序化交易存在较高风险,可能导致重大本金损失。文中涉及的测试框架、Mock对象与重试逻辑均为技术原理演示,未经完整工程化封装,直接复制使用可能存在接口抽象不完整、结果码覆盖不全、重试上限缺失、浮点规整误差、测试环境与实盘环境不一致等缺陷,需经人工审查、编译测试与充分的模拟盘验证。单元测试全部通过,只说明被测分支在给定输入下的行为符合预期,不说明策略在真实市场中有效。文中代码中的手数、价格与账户数值均为示例占位,与任何真实账户或真实策略无关。文中API名称、常量与行为描述依据MQL5官方文档与MetaTrader 5帮助文档整理,具体行为以对应build的官方文档与实测结果为准。实盘应用前请自行决策并承担相应风险。本网站仅提供软件开发技术服务,不涉及任何交易平台运营、经纪业务或投资咨询业务。
第三方免责声明:本文仅代表作者个人技术观点,与任何经纪商、交易平台或金融机构无关。文中提及的MetaTrader 5、MQL5、MetaEditor、CTrade、MqlTradeResult、MqlTradeRequest、OrderSend、ITradeExecutor、CMockTradeExecutor、CTestCase、ResultRetcode、ResultVolume、TRADE_RETCODE_DONE、TRADE_RETCODE_PLACED、TRADE_RETCODE_DONE_PARTIAL、TRADE_RETCODE_REQUOTE、TRADE_RETCODE_NO_MONEY、TRADE_RETCODE_INVALID_STOPS、TRADE_RETCODE_INVALID_VOLUME、TRADE_RETCODE_TOO_MANY_REQUESTS、SYMBOL_VOLUME_STEP、SYMBOL_VOLUME_MIN、SymbolInfoDouble、MathFloor、NormalizeDouble 等名称与产品,其商标与权利归各自所有者所有,本文仅作技术说明与交流引用,不构成任何推荐、背书或商业合作关系。文中关于结果码含义、程序类型与入口函数的描述依据公开文档整理,具体表现以各版本官方说明与实测为准。读者应自行核实相关信息,因使用本文内容而产生的直接或间接损失,作者不承担任何责任。本文不推荐任何具体的经纪商、交易平台或EA产品。
扫码关注,获取更多EA开发干货
微信公众号
视频号
