文件与表头错误
先解决编码、引号和列名问题,再排查具体商品。
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 会跳过的所有行。
P001查看规则
商品与变体校验
修改业务值前,核对报错商品及完整选项组合。
Validation failed: options are not unique
在同一 handle 内比较完整的 Option1–3 值,查找重复变体组合。
V001 检查当前文件内的重复;无法查看店铺现有变体,也不能判断哪行数据正确。
Shopify CSV “Price can’t be blank”:需要检查什么
如果 Shopify 报告价格缺失,先核对具体商品或变体行再修改。空 Price 并非总会被拒绝:当前格式文档描述了价格默认为零的行为。
图片处理
CSV 图片字段可能通过语法检查,但 Shopify 仍无法获取或处理远程文件。
Incorrect header check
检查报错行的图片;如果移除该图片后导入错误消失,可尝试更换图片托管位置。
I001 只检查图片 URL 语法;不检测此类远程图片错误、不下载图片,也不验证尺寸。
再次导入前检查可检测的问题
保留原始 CSV,选择创建或更新模式并检查本地报告。业务值和有歧义的引号需要手动修正。修改后先在 Shopify 小批量验证;扫描无问题不保证平台接受导入。返回会打开新的校验器,之前选择的文件不会保留。