采集只完成一部分时，先保留已有结果，再区分“没有发现商品链接”和“发现链接但读取失败”。两种问题的排查方向不同，直接把同一个集合反复重跑，可能只会增加重复记录。
本文适合使用 Onwook Import 整理有权使用的公开 Shopify 商品资料的团队，重点是采集阶段的完整性检查。已经拿到 CSV 后的字段映射和导入验收，可继续阅读CSV 导入前检查清单。封面为流程概念插画。
先确认“应该有多少个”是怎样得出的
把商品数、变体数、集合页展示数量和导出文件行数分开记录。示例：一个商品有三种尺寸，不能据此要求任务列表出现三个独立商品；CSV 中同一商品的多行记录，也不能简单当成多个新商品。此处数字仅用于说明计数方式。
对照时使用同一来源链接、语言或地区版本与检查时间。集合内容可能变化，筛选或分页也可能改变看到的范围。Shopify 官方允许商家管理集合的渠道可用性与发布时间，因此后台集合范围和某个公开页面的可见范围不能直接画等号，参见集合设置说明。
用四项记录定位缺口
- 来源范围：提交的是单商品、某个集合，还是带筛选条件的页面？保留完整来源地址。
- 任务设置：查看本次选择的数量、分页范围和当前套餐限制，避免把主动设置的上限误认为故障。
- 实际结果：分别记录已采集商品及缺失样例，不仅记录一个总数。
- 停止原因：保留任务状态、错误原文和发生时间，不把“部分完成”统一归结为网络差。
Onwook Import 产品页说明，失败、中断与部分完成任务会保留结果及原因，并提供商品预览和 CSV 导出。任务有保留期限，应以当前产品页和任务显示为准，及时保存需要的资料。
没有发现链接，先查集合入口
从缺失商品中选取两三条有代表性的公开链接，与集合中已经出现的商品比较。确认缺失商品是否确实属于本次入口、是否在同一地区可见，以及是否需要继续翻页或额外交互才能看到。仅凭浏览器某次显示过商品，不能证明采集器已获得对应链接。
如果页面依赖特殊的动态加载或自定义结构，先用少量样例确认是否支持，不要把整站重复提交当作结构适配。不存在可验证的完整清单时，报告应写“已获得这些结果，完整性尚未确认”，不能宣称全店采集完成。
发现链接但读取失败，按原因决定下一步
- 打开一条失败的公开链接，确认它仍是目标商品，而不是已删除页面或跳转后的其他内容。
- 核对任务提供的原因。若提示限流或等待重试，遵守等待安排，避免同时创建相同来源的任务。
- 若提示访问限制、验证码或密码保护，停止自动重试；请来源方提供获准使用的导出或其他授权渠道。
- 若提示资料不完整或无法识别，保留链接和原始提示，提交支持评估，不手工猜测缺失价格、币种或库存。
浏览器可打开而工具失败，也不代表应绕过对方的访问规则。网络、页面结构和访问条件需要分别判断；工具不会因此获得非公开资料的访问权限。
重试前先保存，重试后再核对差异
保存已有结果和失败清单，记录本次重试要验证的问题。可以先用一个获准访问的失败样例验证修复，再扩大范围。整理多个任务的结果时，以来源链接及目标平台所需标识核对重复，不只按标题判断，因为不同商品可能同名。
示例验收记录可写为：“入口 A；期望范围来自人工核对的清单；成功项已保存；缺失项分别记录原因；本轮补采新增若干项；仍待核对若干项。”数字必须来自实际记录，无法确认的项目保持待核对。
什么时候需要定制方案？
当多个样例都显示相同的结构适配问题，或需要额外字段、特定导出格式和内部系统连接时，可通过插件与应用开发服务评估定制采集范围。若后续问题发生在目标 Shopify 店铺的商品展示，可结合Shopify 开发服务梳理。
联系 Onwook，提交采集不完整的样例。请提供来源链接、任务时间、期望范围依据、两三条缺失商品和脱敏错误信息，不要发送来源站账号密码或访问凭据。
资料核验与更新时间：2026 年 9 月 28 日。本文不保证所有页面结构均可采集，也不把公开可访问等同于有权复制和使用商品内容。
