同一份税率文件重复导入后，后台出现多条看似相同的税率，结账金额也开始漂。肉眼看“*”、空值和0-99999像同一范围，但Magento用于匹配和判断重复的字段并不相同。

先说结论

先用一个真实失败样本复现，不要一上来全量重建。把请求、实体ID和时间记下来，后面的SQL与日志才能对得上。

定位过程

  • 导出当前税率，比较tax_country_id、tax_region_id、tax_postcode、zip_is_range和range字段。
  • 检查CSV是否被Excel自动把邮编前导零去掉。
bin/magento tax:rate:list 2>/dev/null || true
mysql -e "SELECT tax_calculation_rate_id,code,tax_country_id,tax_region_id,tax_postcode,zip_is_range,zip_from,zip_to,rate FROM tax_calculation_rate ORDER BY code;"
mysql -e "SELECT code,COUNT(*) c FROM tax_calculation_rate GROUP BY code HAVING c>1;"

日志取样要带上请求时间、Store View、实体ID和部署版本。只截一行异常往往不够，至少保留错误前后几十行，才能判断是入口参数还是后续状态被改写。

可执行方案

先备份tax_calculation_rate及关联表。将无邮编限制统一为*，范围税率明确设置zip_is_range=1及起止值；CSV邮编列按文本处理。删除重复记录前检查tax_calculation_rule_tax_rate，保留被规则引用的正确rate_id并重绑关联，再清理重复项。之后用固定导入模板做一次小范围验证。

实施时的顺序

  • 先做数据与配置备份，记录当前值。
  • 只改一个变量并重跑失败样本。
  • 确认新数据正确后，再处理历史受影响记录。
  • 最后恢复定时任务或缓存。

上线后观察什么

  • 同一code只剩一条有效税率
  • 购物车用范围内、范围外和前导零邮编各测一次
  • 税额与后台Tax Rule优先级一致
  • 再次导入不会新增重复行

验收不只看后台提示“成功”。我还会从前台/API再走一次真实链路，并在下一轮cron、索引或缓存命中后重复检查，确认不是短暂正常。

风险点

不要只按code直接DELETE；一个税率可能被多个Tax Rule引用，先处理关联关系。