Skip to content

邮件标题:20260909-技术评审-营销活动中心-B端出货明细表退货地址修复

邮件正文:

晓娜、建新:
已完成针对【B端出货明细表退货地址修复】的技术评审,现将评审结论、风险判断及后续执行安排同步如下,便于各方对齐认知并落实执行。

项目名称: 营销活动中心
评审时间: 2026/09/09
参与评审人: 马奇、李明非、邱毅、邢健、张建利、孙传熙、朱鸿君、曹旭、张喜、潘玉平、王建朝、刘晓娜
评审结果: 通过

一、技术方案背景 ​

  • 业务场景:2026-09-02 高德地图(逆地理编码)异常,导致退货动作发生时本应通过逆地理编码/退货单回填的退货地址未能落库到 shipment_report_details_v2,产生 return_address 为空的异常数据;与同期出货地址、签收地址为空同源,出货/签收已有独立修复 Job,本次为退货地址补充新增修复任务 fixShipmentReturnAddress,窗口 2026-09-02 ~ 2026-09-04 内待修复 42031 条。

二、技术方案要点 ​

  • 整体流程:新增第三个独立 XXL-Job fixShipmentReturnAddress(与出货/签收 Job 并列)→ 按 return_time 时间窗口过滤并叠加 keyset 游标分批查询"有退货单且退货地址为空"的行 → 按 return_order_form_id 关联 MongoDB return_order_info,优先取 scanAddress 直接回填,缺失则用经纬度调高德逆地理编码补齐,两者都不可用则跳过 → 经 StarRocks Stream Load 列模式部分更新,仅覆盖 return_address(及 update_time)。

三、决议事项 ​

  • 逆地理编码依赖高德,执行过程增加缓存,减少高德接口压力,提升系统稳定性。

四、风险提示 ​

  • 逆地理编码依赖高德,虽已限流 QPS≤5 并加两级缓存保护配额,仍存在高德再次异常导致修复中断或失败的可能。

五、方案地址 ​

技术方案:https://yldc.coding.yili.com/p/sip-mac/wiki/54311#user-content-一背景与问题