聚宽平台如何排查未来函数与回测撮合幻觉？（附避坑指南与代码示例）

在量化交易中，回测结果异常优异（如收益率暴增、回撤极小）往往并非因为策略本身完美，而是由于引入了未来函数或产生了订单撮合幻觉。以下是使用聚宽（JoinQuant）回测系统排查这些问题的完整指南：

一、 如何排查与避免“未来函数”

未来函数是指在历史某个时间点，策略使用了该时间点之后（未来）才发生的数据。这会导致回测时“未卜先知”，实盘时却大幅亏损。

1. 开启聚宽内置的避免未来数据模式

聚宽提供了实验性的安全设置，可以在初始化中开启：

def initialize(context):
    # 开启避免未来数据模式（默认关闭）
    set_option("avoid_future_data", True)

• 效果：开启后，如果策略在运行中尝试通过 API 获取当前逻辑时间（context.current_dt）之后的数据，系统会直接抛出 FutureDataError 异常，强行中断并提醒开发者。
• 局限性：此功能无法检测外部导入的数据（如自行读取的本地文件、网络请求数据）或硬编码的特定历史牛股池。

2. 规范数据获取 API 的使用

• get_price 与 get_bars：在使用这些 API 获取历史数据时，必须确保 end_date 或 end_dt 参数不要大于当前逻辑时间 context.current_dt。推荐不传 end_date（默认即为当前时间）或显式传入 context.current_dt。
• get_fundamentals：财务数据极易引入未来函数。在回测中，如果不传入 date 参数，默认会取 context.current_dt 的前一天，这是安全的。如果手动传入 statDate（如指定季度 2023q1），由于上市公司财报披露存在滞后性，极易引入未来数据。建议在盘后（15:00后）或使用 date 参数查询当时已披露的最新数据。
• 动态复权模式：强烈建议在 initialize 中开启真实价格（动态复权）模式：

  set_option('use_real_price', True)
  

  传统前复权模式在回测历史时刻时，使用的是基于未来的复权因子计算的价格，天然带有未来函数属性。开启真实价格模式能有效避免这一问题。

二、 如何排查“订单撮合幻觉”

撮合幻觉是指回测系统在不合理的价位或超大成交量下，判定你的订单“完美成交”，而实际市场中根本无法实现。

1. 设置合理的滑点（Slippage）

如果不设置滑点，系统默认使用 PriceRelatedSlippage(0.00246)。为了更贴近实盘，应根据标的流动性主动设置滑点：

# 为股票设置百分比滑点（双边）
set_slippage(PriceRelatedSlippage(0.00246), type='stock')
# 为特定期货合约设置跳数滑点
set_slippage(StepRelatedSlippage(2), type='futures', ref='RB')

2. 限制单笔订单成交量比例

在真实市场中，你的买卖盘会冲击市场。如果你的下单量超过当时市场成交量的很大比例，是不可能按现价全部成交的。聚宽提供了成交量比例限制：

def initialize(context):
    # 限制单笔订单成交量不超过本日该股票总成交量的 25%
    set_option('order_volume_ratio', 0.25)

开启后，无论是市价单还是限价单，撮合时都会严格受到全市场实际成交量的比例限制，超出部分市价单会撤单，限价单会挂单等待。

3. 警惕非交易时段下单与涨跌停撮合

• 涨跌停限制：未启用盘口撮合时，若标的“最新价+滑点”已达涨停，市价买单会被撤销；跌停时，市价卖单会被撤销。排查策略是否在涨跌停板上实现了“不可能的成交”。
• 非交易时段下单：在非交易时间下单，订单会挂单。日频策略会在开盘时尝试撮合，分钟/tick策略会在下一个Bar完成时撮合。需注意开盘集合竞价阶段（09:25-09:30）的成交量检查，模拟盘若截至下单时刻累积成交量为0，会拒绝交易。

三、 策略健康度自检清单