Shopify 将产品图片限制为 20 MB 和 2000 万像素，应用会自动缩小更大的图片。大多数匹配问题源于标识符重复、标识符为空或文件名中的小错误，这些都能在上传前的预览中看到。
限制
| 限制 | 数值 | 应用的处理方式 |
|---|---|---|
| 文件大小 | 20 MB（Shopify） | 缩小并重新编码 jpg、jpeg、png、webp、gif。仍无法满足时才会给出明确的错误。 |
| 分辨率 | 2000 万像素（Shopify） | 缩小到约 1800 万像素后重试。 |
| 每个产品的图片数 | 250 张（Shopify） | Shopify 自身的限制 |
| 免费套餐 | 累计 25 张 | 任务会因“Free upload limit reached”而停止。 |
| 预览表格 | 每个表格显示 5,000 行 | 计数和 CSV 导出涵盖全部内容。 |
| 匹配结果 | 保留 2 小时 | 超过时间请重新匹配。 |
| Shopify 文件速率限制 | 针对整个店铺 | 自动等待（3 秒 → 6 秒 → 12 秒）后重试。 |
超出限制的图片会在上传之前列在预览页面的警告中。
推荐规格： JPG 或 WEBP，长边 2048 到 4096 像素，sRGB，小于 5 MB。
大批量上传需要多长时间
Shopify 会限制整个店铺中文件的变更速度。应用会并行下载和上传，达到限制时自动放慢速度，因此大型任务会稳步而非快速地推进。数万张图片需要以小时而不是分钟来估算。进度按图片逐张保存，重启后会从中断处继续。
匹配问题
| 症状 | 可能原因 | 解决方法 |
|---|---|---|
| 一张图片都没匹配上 | 匹配类型或文件夹选错，或多属性的标识符为空 | 将 Expected SKU 列与产品数据进行比对 |
| 部分图片未匹配 | 输入错误、末尾空格、缺少扩展名、非数字后缀 | 导出未匹配图片的 CSV，与产品导出数据进行比对 |
| 图片匹配到了错误的多属性 | 标识符重复，或“包含”选项匹配到了较短的编码 | 改用精确匹配，或让编码保持唯一 |
| SKU 重复导致匹配数偏少 | 同一标识符只保留第一个多属性 | 联系我们开启多属性匹配，或让标识符保持唯一 |
| 带重音字符的标题匹配失败 | 文件名（macOS）与 Shopify 中重音字符的编码不同 | 联系我们开启 Unicode 规范化，或改用 SKU 匹配 |
| 编辑过的产品仍按旧值匹配 | 目录已被缓存 | 点击 清除缓存 |
| 新图片没有显示 | 文件夹列表已被缓存 | 点击 重新匹配，或刷新文件夹选择器 |
| 匹配超时 | 目录和文件夹都非常大 | 联系我们开启产品系列筛选，或拆分文件夹 |
上传消息
| 消息 | 含义 | 处理方法 |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | 无法缩小到限制以下 | 将图片导出为更小的尺寸 |
hit the Shopify file rate limit; retrying in Ns | Shopify 的正常限速 | 无需处理，应用会自动重试 |
Your shop reached Shopify API rate limit | 其他应用或任务正在使用 API | 避免同时运行两个大型任务 |
Free upload limit reached | 25 张免费额度已用完 | 升级套餐 |
This folder already in process | 该文件夹的任务仍在运行 | 等待完成或停止任务 |
product has only default variant… | 图片关联到了产品而非多属性 | 属于正常行为 |
任务以 finished with errors 结束 | 部分图片失败 | 查看错误行。失败的图片会自动重试 |
试运行检查清单
- 只有一张图片的产品获得一张图片，并被设为多属性图片。
- 有多张图片的产品按
_0/_1/_2顺序获得图片。 - 多个多属性的产品中，每个多属性显示各自的图片。
- Shopify 中的替代文本与预览一致。
- 故意写错的文件名出现在未匹配图片列表和 CSV 中。
- 在测试产品上使用替换模式后，只保留新的一组图片。
获取帮助
请 联系我们，并提供店铺域名、文件夹名称、匹配类型、大致运行时间，以及两三个示例文件名和它们本应匹配的 SKU 或条形码。我们可以记录一次匹配的完整追踪，准确告诉您图片为什么会这样匹配。