Shopify CSV 导入报错 “Validation failed: Value must be a valid product reference” 的解决方法

CSV 中的某个元字段引用了店铺里还不存在的商品。先在不填这些元字段值的情况下导入商品,再把值补回去,勾选 “Overwrite products with matching handles” 重新导入。

Shopify 显示的报错

Validation failed: Value must be a valid product reference

这个报错是什么意思

有些元字段(例如相关商品、搭配商品)保存的是对另一个商品的引用。Shopify 只接受对店铺中已经存在的商品的引用。如果被引用的商品是由同一个 CSV 创建的,或者根本不存在,导入就会以这个报错失败。

常见原因

  • 被引用的商品在同一个文件中,Shopify 检查引用时它还没有被创建。
  • 被引用的商品已从店铺中删除。
  • 引用值有错别字,或者与任何已有商品都不匹配。

解决方法

  1. 先保存一份文件副本,保留元字段的值。
  2. 在要导入的文件中,清空商品引用类元字段列中的值。
  3. 导入文件,所有商品都会先在没有引用的情况下创建。
  4. 把元字段的值恢复到 CSV 中。
  5. 勾选 “Overwrite products with matching handles” 再次导入。此时被引用的商品都已存在,引用就能被接受。

如何避免

  • 先导入新商品,再导入任何引用它们的文件。
  • 按 Shopify 的建议,把带引用的导入分成两步进行。

检查文件中的其他问题

Skuvera 无法在导入前发现这一类问题,但它会在浏览器中按 Shopify 的其他规则检查你的商品 CSV,帮你一次修好其余问题。免费,无需注册。

常见问题

为什么要导入两次?
Shopify 在导入每个商品时检查它的引用。同一文件中稍后才创建的商品,在那一刻还不存在,所以第一次导入用来创建商品,第二次再加上引用。
覆盖选项会改动其他数据吗?
它会用 CSV 中包含的列的值,替换 handle 相同的商品的对应数据。文件中没有的列会保留原来的值。

了解更多

查看 Shopify 官方说明

其他导入报错

更新于 2026年10月30日