核心要点
馈赠活动赠券中断的根因：posserver消息队列配置未开启。
关联概念
- 典型现象：馈赠活动运行2个月后突然无法赠券，POS端交易时仍能看到活动提示
- 数据特征：POS库有馈赠流水，ERP库无对应记录——POS端成功但未同步后台
- 根因：posserver 的
Cust.xml配置中馈赠相关消息队列功能未开启 - 解决：修改
Cust.xml，将馈赠相关参数配置为开启（与流水配置方式一致）
应用场景
- 卡折扣供应商承担折让未生效排查：同类对比——同为促销活动配置问题
- 超市自助异常流水处理：同类对比——同为POS端数据同步问题
- POS馈赠与赠品功能：延伸应用
- 抖音收款报错与WS服务更新：同类对比
- 美团券核销Session异常处理：同类对比
- 自助流水未同步业务库排查：同类对比
- 满赠活动数据同步配置：同类对比
- 静默失败排查-日志缺失证据法：延伸应用——静默失败类故障案例
常见误区
- 场景1：馈赠活动赠券中断，POS有提示但不出券
- 场景2：POS有流水但后台无记录
- 场景3：促销活动相关消息队列排查
参考来源
- 误区1：活动配置问题 → 正确做法：先查 posserver 消息队列配置（Cust.xml）
- 误区2：活动到期自动停止 → 正确做法：检查活动是否仍在有效期内，再看消息队列
变更日志
- Shine-Hamster > 02-Areas/06-故障沉淀/问题-馈赠活动赠券中断与POS配置-20260713.md
排查指引
- 2026-08-05：初始创建（消化 Shine-Hamster 故障沉淀）
正文
- 症状：馈赠活动不出券，POS有提示
- 检查：① POS库馈赠流水是否存在 ② posserver
Cust.xml馈赠消息队列配置 - 处理：开启馈赠消息队列 → 验证赠券恢复 → 确认数据同步