指南
Shopify

Shopify CSV 导入错误:找到对应的修复方法

先查看 Shopify 导入报告中的报错,再使用下面经过验证的引号、表头和选项指南,并了解本地 CSV 扫描的检测范围。
官方资料核对日期:2026 年 10 月 1 日。错误原文保留英文;跳过行条目显示不含动态行号的原文片段。

文件与表头错误

先解决编码、引号和列名问题,再排查具体商品。

Illegal quoting on line

检查 UTF-8 编码以及报错记录附近未闭合或多余的直引号。

F002 检查编码,F003 检查引号;有歧义的引号需要手动复核。

Invalid CSV header: missing headers

根据创建商品、更新商品或新增变体的意图,核对第一行所需字段。

H001 检查 Title,H002 检查 URL handle 要求;未知列另行复核。

跳过行

检查 Shopify 为什么忽略某行。缺少商品数据与店铺已存在相同 handle 需要不同处理;本地扫描无法查看现有商品或覆盖设置。

…did not contain product data

先检查商品首行是否缺少 Title,再判断续行是否属于单独商品。

P001 检测商品首行缺少 Title,并排除仅图片续行;它不能预测 Shopify 会跳过的所有行。

商品与变体校验

修改业务值前,核对报错商品及完整选项组合。

Validation failed: options are not unique

在同一 handle 内比较完整的 Option1–3 值,查找重复变体组合。

V001 检查当前文件内的重复;无法查看店铺现有变体,也不能判断哪行数据正确。

Shopify CSV “Price can’t be blank”:需要检查什么
如果 Shopify 报告价格缺失,先核对具体商品或变体行再修改。空 Price 并非总会被拒绝:当前格式文档描述了价格默认为零的行为。
Shopify CSV “Inventory quantity is not a number”:修复方法
检查报错行的 Inventory quantity 是否包含文本或电子表格错误;先确认应使用商品 CSV 还是独立库存 CSV。
Shopify CSV “Default Title already exists”:排查变体
“Validation failed: The variant 'Default Title' already exists” 可能指向默认变体或选项数据冲突。修改选项前核对整个商品组及店铺现有变体。

图片处理

CSV 图片字段可能通过语法检查,但 Shopify 仍无法获取或处理远程文件。

Incorrect header check

检查报错行的图片;如果移除该图片后导入错误消失,可尝试更换图片托管位置。

I001 只检查图片 URL 语法;不检测此类远程图片错误、不下载图片,也不验证尺寸。

再次导入前检查可检测的问题

保留原始 CSV,选择创建或更新模式并检查本地报告。业务值和有歧义的引号需要手动修正。修改后先在 Shopify 小批量验证;扫描无问题不保证平台接受导入。返回会打开新的校验器,之前选择的文件不会保留。

官方来源: Shopify:常见导入问题 · Shopify:商品 CSV 选项与变体 ID