🔁 库存同步延迟导致补货数据异常

核心要点

库存同步任务执行失败或延迟，导致补货建议数据未及时更新，门店看到错误的补货建议数量。

关联概念

1. 根因：凌晨自动同步任务执行失败，可能是网络波动、数据库锁、或同步脚本异常
2. 影响：门店补货建议数据不准确，可能导致补货不足或过度补货
3. 解决：手动触发库存同步任务，等待同步完成后补货建议自动恢复

应用场景

• 补货算法运行机制：前置基础——补货建议依赖库存数据
• 库存同步任务：同类对比——同步失败是常见故障类型
• 银行卡消费额统计口径：同类对比——同为数据口径/取数问题
• 供应商出货与批次勾对统计口径：同类对比
• 超市自助异常流水处理：同类对比

常见误区

• 场景1：门店反馈补货建议数量异常（为0或明显不合理）
• 场景2：补货建议数据长时间未更新（超过24小时）
• 场景3：库存数据与补货建议不一致

参考来源

• 误区1：认为是补货算法问题 → 正确做法：先检查库存同步状态，90%是同步延迟导致
• 误区2：直接修改补货建议数据 → 正确做法：修复同步任务，让系统自动计算正确数据

变更日志

• 轻量工作记录 2026-08-03：XX门店补货数据异常排查

排查指引

• 2026-08-03：初始创建

操作速查

• 症状：门店反馈补货建议数量异常（为0或不合理）
• 检查：库存同步日志（查 inventory_sync_log 表，筛选最近24小时记录）
• 处理：

1. 确认同步任务是否执行失败
2. 如失败，检查失败原因（网络/数据库锁/脚本异常）
3. 手动触发同步任务
4. 等待5-10分钟后验证补货建议是否恢复

SQL速查

1. 检查同步状态：查询 inventory_sync_log 表最近记录
2. 手动触发同步：执行同步脚本或调用同步接口
3. 验证结果：检查补货建议表数据是否更新

正文

-- 检查库存同步日志（最近24小时）
SELECT sync_time, status, error_msg, sync_duration
FROM inventory_sync_log
WHERE sync_time >= DATE_SUB(NOW(), INTERVAL 24 HOUR)
ORDER BY sync_time DESC;

-- 检查补货建议数据更新时间
SELECT store_id, sku_id, suggest_qty, update_time
FROM replenishment_suggestion
WHERE store_id = '门店ID'
ORDER BY update_time DESC
LIMIT 10;