订单跟踪严重 Bug 完整因果链分析

本文档汇总当前系统订单跟踪存在的严重 bug，按「输入 → 状态变化 → 调用路径 → 出错点 → 根因」建立完整因果链。

架构与数据流概览

flowchart LR
  subgraph input [输入源]
    WS_Order[orderUpdates WS]
    WS_Fill[userFills WS]
  end
  subgraph pub [发布端]
    EWM[EnhancedWebSocketManager]
    EB_WS[EventBus_WS]
  end
  subgraph sub [订阅端]
    EB_Exec[EventBus_Exec]
    WOM[WebSocketOrderManager]
    Exec[Executor]
  end
  WS_Order --> EWM
  WS_Fill --> EWM
  EWM --> EB_WS
  EB_WS -.->|"无连接"| EB_Exec
  EB_Exec --> WOM
  EB_Exec --> Exec

• 发布端：交易 WS 在 src/utils/websocket/enhanced_ws_manager.py 内创建自己的 self._event_bus = EventBus()（L315），在 _cache_latest_data 中根据 channel 调用 _publish_order_status_events / _publish_fill_events，向该实例发布事件。
• 订阅端：Executor 在 src/trading/executor.py L89 创建 self._event_bus = EventBus()，L146 将该实例传给 WebSocketOrderManager(executor=self, event_bus=self._event_bus)，L98-99 在 WebSocketOrderManager 内订阅 OrderStatusEvent / OrderFilledEvent。
• 创建交易 WS 时：src/services/realtime_kline_service_base.py L358-375 调用 EnhancedWebSocketManager(...) 时未传入任何 event_bus，因此交易 WS 使用内部新建的 EventBus，与 Executor 的 EventBus 不是同一实例。

Bug 1（P0）：双 EventBus 隔离 —— 订单/成交事件从未被消费

因果链

实际行为与影响

• WebSocketOrderManager 从未收到任何 OrderStatusEvent / OrderFilledEvent，因此：
  • _ws_status 不会更新，宽限期/填单逻辑不触发；
  • _accumulate_fill 不执行，has_fill_price 始终为 False，成交价依赖 2s 早期 HTTP 或超时后 HTTP 兜底。
• 等价于「WS 订单追踪静默失效」，仅靠 HTTP 路径工作。
• 同源影响：同一交易 WS 发布的 WebSocketReconnectedEvent、PositionUpdatedEvent、BalanceChangedEvent 等若仅由 Executor 通过 executor._event_bus 订阅，同样收不到（重连后补查依赖的 WebSocketReconnectedEvent 也不会到达 Executor）。

Bug 2（P1）：空 fill_id 导致去重失效、少计成交

因果链

当前发布端情况

• enhanced_ws_manager.py 的 _publish_fill_events 仅在 tid is not None 时发布，且 fill_id=f"tid:{tid}"，故当前从 userFills 来的事件不会出现空 fill_id；问题会在其他来源或未设 fill_id 时暴露。

Bug 3（P2）：重连后仅「PENDING 且 _ws_status is None」才被 HTTP 补查

因果链

与历史文档的对应关系

• BUG-1（userFills 解析）：设计上已改为 EventBus 路径，直连 handle_message/_on_user_fill 已删；发布端 _publish_fill_events 使用 data.get("fills", []) 和 order_id=str(oid)、fill_id=f"tid:{tid}" 已正确。当前真正的问题是事件送不到 WebSocketOrderManager（Bug1 双 EventBus）。
• BUG-2（orderUpdates 拒绝状态）：当前 _on_order_status_event 已用 "rejected" in status_str 覆盖 minTradeNtlRejected 等，已修复。
• BUG-3（order_id 类型）：发布端已统一 order_id=str(oid)，已修复。
• BUG-5（fill_id）：发布端有一等字段 fill_id=f"tid:{tid}"；消费端需防空 fill_id（即本分析中的 Bug2）。

修复优先级与要点

建议先做 P0：在 realtime 服务创建交易 WS 时注入 executor 的 _event_bus，并让 EnhancedWebSocketManager 支持可选 event_bus 参数；再在 WebSocketOrderManager 侧对空 fill_id 做防护（P1）。