2. 跨模块事件传递的链路设计：IPC方式、接口契约、事件总线选型

跨模块埋点事件传递的链路设计是架构的核心难点。设计不当会导致模块间强耦合、事件丢失、链路追踪困难。本章从模块边界与分层职责出发，对比IPC、接口契约、事件总线三种链路方式的适用场景与风险，并给出标准化的落地步骤和验收标准。

2.1 模块边界与分层职责

在模块化/组件化架构中，埋点事件的生产者与消费者分属不同模块，必须明确划定边界和分层职责：

• 事件生产者（Producer）： 业务模块（如订单、支付），负责构造标准化事件模型。
• 序列化适配层（Serializer）： 跨进程时负责 Parcelable/JSON 序列化；同进程时负责深拷贝与字段校验。
• 事件管道层（Pipeline）： 负责事件的投递、路由、分发。这是链路设计的核心区域。
• 反序列化适配层（Deserializer）： 将管道数据还原为事件模型。
• 事件消费者（Consumer）： 埋点 SDK 或数据分析模块，负责最终上报。

层级之间通过接口契约解耦，通过信任链路监控保证数据不丢不重。

2.2 状态数据流与控制流

状态数据流方向：事件对象（BaseEvent）从左至右流动，经过序列化、投递、路由、反序列化最终到达消费者。控制流包含订阅注册、事件分发、ACK 回调、异常重试。同进程场景下推荐使用同步分发保证时序；跨进程场景下必须考虑 binder 线程池耗尽和死锁风险。

典型的事件模型定义：

// 标准化事件模型（跨模块传递的契约）
public class BaseEvent {
    public String eventName;      // 埋点名称
    public Bundle payload;        // 业务参数
    public long timestamp;        // 事件时间戳
    public String traceId;        // 全链路追踪 ID
    public int seqId;             // 模块内序号（用于连续性检查）
}

2.3 选型权衡分析

2.4 风险点与信任链路

信任链路设计： 在管道层插入监控探针，采集事件序号、时间戳、生产/消费状态。监控组件独立于业务线程，通过异步日志输出到本地存储，供后期 Debug 和 SLA 评估。

2.5 落地步骤与验收标准

标准化落地步骤：

1. 定义事件契约： 输出 BaseEvent 抽象类，包含 eventName、traceId、timestamp、payload。模块间依赖此包。
2. 选型管道组件： 同进程推荐 EventBus（APT 索引，避免反射）。跨进程推荐封装 Binder 连接池。
3. 实现 SPI 接口： 各模块提供 AnalyticsService 接口，内部隐藏具体选型细节。
4. 植入信任监控： 在生产者和消费者侧分别埋点计数器，定时上报到监控模块。
5. 集成测试： 编写跨模块事件的单元测试和压力测试，覆盖序列化、分发、重试三大场景。

验收标准：