导入中断后重传同一份 CSV 商品数量翻倍怎么办

现象#

导入跑到一半页面刷新，进度条消失，重新上传同一份文件后 Products 从 3,100 涨到 5,980，同一个 SKU 出现两条记录。

原因#

• 导入任务一旦开始就不能取消，后台也没有历史记录，无法判断上次是否跑完
• 第二次上传时 Handle 被工具改写（加后缀或编号），会被当作新商品创建
• 没勾覆盖时相同 Handle 被静默忽略，看起来像没导入，很容易再传一次
• 任务卡在队列里需要平台支持清理，重复提交只会叠加待处理任务

处理步骤#

1. 导入前导出商品，保存 Handle 与 Variant SKU 两列作为基线
2. 重跑前做差集，只保留基线里不存在的 Handle，生成增量文件
3. 同一商品二次导入必须勾选 Overwrite products with matching handles
4. 以 SKU 为幂等键：df.drop_duplicates(subset=['Variant SKU'], keep='first')
5. 已产生的重复商品按创建时间保留最早一条，其余归档后删除

验收标准#

商品总数等于基线数加增量 Handle 数，导出文件里任一 SKU 只出现一次。