邮件标题:20260903-技术评审-营销活动中心(奶酪)-码流向解析顺序问题修复
邮件正文:
孔玮:
已完成针对【码流向解析顺序问题修复技术方案】的技术评审,现将评审结论、风险判断及后续执行安排同步如下,便于各方对齐认知并落实执行。
项目名称: 营销活动中心-奶酪
评审时间: 2026/09/03
参与评审人: 王建朝、李明非、贾继伟、马奇、张喜
评审结果: 通过
一、技术方案背景
- 业务场景:奶酪事业部码文件与流向文件从 TTS 同步时,存在码文件与流向文件同时上传的场景。该情形下并发解析时,解析流向文件需依赖码文件中的码基本信息,若码文件尚未解析完成会出现"码不存在"告警;当前调度解析具备自动重试机制,告警未影响业务,但告警群频繁刷屏。
- 修复目标:消除并发解析触发的"码不存在"告警,使码文件先于流向文件解析,避免频繁非校验错误告警刷屏。
二、技术方案要点
- 整体流程:调度码流向解析任务前,增加一道前置判断——若存在"正在解析"或"未解析完成"的码文件,则本次跳过(return,等待下次调度,调度间隔 5 秒),否则正常解析流向。
- 调度机制:同步任务每 5 分钟触发一次;解析任务每 5 秒调度一次,扫描未解析完成或正在解析的码任务,发现则跳过。
- 错误处理:流向解析有自动重试机制——校验错误(如主数据无产品、无经销商、码格式不合规)不重试直接告警;非校验错误(代码内空指针、落库失败等)每 5 秒一次共重试 10 次,10 次后落库并依赖人工按单号排查。
- 服务边界:本变更不调整 TDS 接口、不动主数据查询,仅在解析任务调度的入口加一道前置判断。
三、决议事项
- 在未解析入口加前置判断:实现路径明确——在解析任务生成解析消息前判断是否存在未解析完成或正在解析的码任务,存在则 return 跳过、等待下次调度(下次调度 5 秒后),由张喜负责落地。
- 评估业务量与解析时长:现状业务量下,码文件平均几千至几万条,解析在秒级完成,5 分钟调度窗口不会被打满;按当前规模评估极端场景(大数据量长时间占用调度窗口)暂不考虑;如未来码文件量级显著放大(数十兆及以上)需重新评估。
- 重试机制与人工闭环写进方案:方案文档需同步写清两类错误的处理路径:①校验错误不重试、直接发告警;②非校验错误每 5 秒重试 1 次、共 10 次,10 次后落库、按单号走人工排查(告警群有单号),由张喜负责补齐。
- 项目目录归属:奶酪/冷饮相关方案统一迁至奶酪项目目录下,不再混放,本次方案同步迁移到对应位,由张喜执行、马奇协助同步。