Shopify 商品导入报错 “Invalid CSV header: missing headers” 的解决方法

这个报错是什么意思

商品 CSV 的第一行是表头，Shopify 按列名的准确写法识别各列。如果缺少 Title、URL handle（旧版模板为 Handle）等必需列，或者列名写法不同，Shopify 就无法读取文件并会停止导入。

常见原因

• 文件来自其他平台，使用了自己的列名，例如用 Name 代替 Title。
• 编辑文件时删除了某个必需的列。
• 列名多了空格、有错别字，或者措辞与 Shopify 模板不同。

解决方法

1. 下载 Shopify 的商品 CSV 示例文件，或从店铺导出一个商品，查看正确的列名。
2. 把文件的第一行与示例文件逐列对照。
3. 把写法不一致的列名改正，并补上缺少的必需列。
4. 删除每个列名首尾的空格。
5. 以 CSV UTF-8 格式保存，然后重新导入。

示例

Handle,Name,Price
wool-scarf,Wool scarf,24.90

URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name 不是 Shopify 的列名。改成 Title，并把 Handle 改成 URL handle，就与当前模板一致了。

如何避免

• 新文件请从 Shopify 模板或最新的导出文件开始，不要手动拼写列名。
• 使用会把每个列名与 Shopify 新旧两版列名对照的校验工具。

常见问题

还能使用 Variant Price 这类旧版列名吗？

Shopify 仍然接受旧版模板的文件，但一个文件里的列名要统一用同一版。新旧列名混用可能导致列被识别错误。

导入时弹出的 “Choose column headings” 窗口是什么？

当列名不匹配时，Shopify 会显示这个窗口，你可以在里面为每一列手动对应。但直接修正文件中的列名，对以后的导入更可靠。

Skuvera 中的相关检查

• 缺少 Title 列
• 缺少 URL handle 列
• 无法识别的列

其他导入报错

• Shopify CSV 导入报错 “Validation failed: price can't be blank” 的解决方法
• Shopify CSV 导入报错 “Validation failed: options are not unique” 的解决方法
• Shopify CSV 导入报错 “Ignored line because handle already exists” 的解决方法
• Shopify CSV 导入报错 “Ignored line because it did not contain product data” 的解决方法
• Shopify CSV 导入报错 “Network error: Unexpected token < in JSON at position 0” 的解决方法
• Shopify CSV 导入报错