4、特征一致性巡检：在线特征与离线特征的一致性校验方法与常见偏差原因

特征一致性是归因稳定性巡检的基石。在线推理时使用的特征值与离线训练/回测时使用的特征值若存在偏差，将直接导致归因模型在线上表现与离线评估结果不一致，甚至引发归因逻辑错误。本章系统梳理一致性校验的核心方法、自动化巡检策略及常见偏差根因。

4.1 一致性校验的核心维度

在线与离线特征的一致性校验需覆盖以下四个维度，任何一维出现偏差都可能导致归因结果失真：

4.2 自动化校验方法与流程

基于特征平台，我们构建了离线-在线特征一致性巡检流水线，每日自动执行并输出偏差报告。核心流程如下：

1. 样本对齐：从在线日志中抽取最近 N 天的推理请求，提取实体 ID 与请求时间戳；从离线数仓中按相同实体 ID 与时间窗口拉取特征快照。
2. 特征映射：将在线特征名与离线特征名通过特征注册中心进行映射，处理别名、版本差异。
3. 逐值比对：对每一条样本的每一个特征进行精确比对，记录不一致的实体 ID、特征名、在线值、离线值、偏差量。
4. 统计聚合：按特征维度聚合，计算每个特征的不一致率、最大偏差、均方根误差。
5. 告警触发：当特征不一致率超过阈值（默认 0.1%）或分布偏差指标（PSI > 0.1）时，自动创建巡检工单。

# 伪代码：特征一致性逐值比对逻辑
def check_feature_consistency(online_features, offline_features, entity_id, timestamp):
    inconsistencies = []
    for feature_name in online_features:
        online_val = online_features[feature_name]
        offline_val = offline_features.get(feature_name)
        if offline_val is None:
            inconsistencies.append({
                "entity_id": entity_id,
                "feature": feature_name,
                "type": "missing_offline",
                "online_val": online_val,
                "offline_val": None
            })
        elif not approx_equal(online_val, offline_val, rel_tol=1e-5):
            inconsistencies.append({
                "entity_id": entity_id,
                "feature": feature_name,
                "type": "value_mismatch",
                "online_val": online_val,
                "offline_val": offline_val
            })
    return inconsistencies

4.3 常见偏差原因分析

根据特征平台线上巡检数据统计，在线与离线特征不一致的根因可归纳为以下六类：

4.4 偏差根因定位与修复策略

当巡检发现特征不一致时，按以下步骤进行根因定位与修复：

• 第一步：确认偏差范围。通过不一致率按特征、按实体、按时段下钻，判断是全局性偏差还是局部异常。
• 第二步：比对特征计算 DAG。从特征注册中心拉取在线与离线特征的计算 DAG，逐节点比对算子、参数、数据源。
• 第三步：检查时间戳对齐。确认离线回测时使用的特征截止时间是否与在线请求时间一致，特别注意跨天、跨周边界。
• 第四步：执行特征重算。在离线环境中使用在线特征计算代码重新生成特征值，与现有离线特征进行比对，验证代码一致性。
• 第五步：修复与回归。修复偏差后，在巡检流水线中增加对应的回归测试用例，防止同类问题再次出现。

4.5 巡检平台化与持续改进

将特征一致性巡检能力平台化，是保障归因稳定性的长效手段。特征平台应提供以下核心能力：

• 自动化巡检任务编排：支持按特征组、按时间粒度（小时/天）配置巡检计划，自动触发比对流水线。
• 偏差可视化看板：展示各特征的不一致率趋势、TOP N 偏差特征、偏差分布热力图。
• 根因分析辅助：基于历史偏差数据，自动推荐可能的根因类别（时间窗口/计算逻辑/数据源）。
• 修复闭环管理：巡检工单关联修复任务，修复后自动触发回归比对，验证修复效果。