我的二维码无法扫描

首先，把问题一分为二

用普通手机摄像头扫描该码：

• 毫无反应 → 码本身无法被读取。原因 1–4。
• 打开了一个页面，但显示的是提示而非您的护照 → 码读取正常；问题在护照的状态或 GTIN。原因 5–7。

原因 1：印得太小

症状： 码能从您的显示器上扫描，却扫不动印刷的标签，或只有当手机近得不切实际时才能扫到。

小码是最常见的印刷失败，尤其在表面弯曲、起皱的纺织品上。最小尺寸：

• 洗护标签： 20mm
• 吊牌： 25mm 或更大
• 织唛标签： 14mm，从 SVG 织造

解决： 按不低于该放置位置最小尺寸的标准重印。尺寸预设和完整的印刷指引见 下载与打印二维码。

原因 2：对比度低或颜色反相

症状： 码足够大，但扫描器很吃力，尤其在光线不足时。

扫描器预期 浅色背景上的深色模块。重新上色后对比度低的码、浅色叠深色的反相，或印在繁杂图案上的码，都会降低扫描成功率。码周围的白边（静默区）是标准的一部分——图案或标签边缘侵入其中也会破坏扫描。

解决： 尽可能原样使用下载的黑底白色码。如果您的设计师为它重新上色，请保持深色叠浅色并有强对比度、保留静默区，并在量产前测试一份实物样本。

原因 3：文件被转换成了 JPG

症状： 印出的码看起来略微模糊，或方块周围有淡淡的光晕，且扫描不可靠。

PassportCraft 仅导出 SVG 和 PNG——没有 JPG 导出，因此您印刷流程中出现 JPG，意味着有人在中途做了转换。JPG 压缩会糊掉扫描器所依赖的清晰模块边缘。

解决： 回到原始下载件。给印刷供应商发 SVG；如果某个流程必须用栅格图像，请用 PNG。切勿把二者重新另存为 JPG。

原因 4：码受损或放置不当

症状： 码在新的时候扫描正常，但磨损后失败——或只在实物产品上失败，在平整的测试印件上却没问题。

PassportCraft 的码以高纠错生成（可容忍多达 30% 的损坏），但布料是个不友好的环境：印在接缝或折叠线上、印在严重起皱或磨损标签上、或在反光的光面下的码，仍可能失败。

解决： 把码放在远离接缝和折叠的平整区域，优先选择哑光表面，对于严重磨损的标签则重印。如果同一份护照的码在实际使用中反复失败，可考虑把它从洗护标签换到尺寸更大的吊牌上。

原因 5：护照是草稿

症状： 码能扫，打开了一个页面——但它显示 “此护照尚未发布”，并带有一个登录选项。

二维码的 URL 永不改变，但它只在护照处于 已发布 状态时才解析到已上线的护照。草稿——包括一份曾经发布、随后被取消发布的护照——会改为显示这条中性提示。不会暴露任何产品数据，您自己的团队可以从该页面登录以预览草稿。

解决： 发布该护照。已印好的码会立即体现这一变化——无需任何重印。

原因 6：护照因方案变更而被停用

症状： 页面显示 “此数字产品护照已临时停用。请联系品牌方获取产品信息。”

这是被方案降级下线护照的提示——例如当已发布护照在宽限期后超出了新方案的上限时。参见 升级、降级与宽限期，了解这是如何发生的、以及如何避免。

解决： 释放发布名额或升级，然后重新发布该护照。

原因 7：GTIN 不匹配

症状： 页面显示 “此数字产品护照不可用。”

二维码中的 URL 由一个 GTIN 构建——而系统中没有护照与之匹配。常见原因：码印好后护照的 GTIN 被更改了、标签上的码是由错误的 GTIN 生成的，或一个序列化 URL 指向了没有任何护照拥有的序列号。

解决： 打开护照，把它的 GTIN（以及序列号，如有使用）与二维码面板中显示的 编码 URL 对照，再与印出的内容对照。这些 URL 如何构建，在 GS1 Digital Link 详解 中介绍。

相机应用与扫描器应用

任何现代手机摄像头都能读取这些码——它们是含有普通 https URL 的标准二维码，无需专门的应用。如果某个相机扫不到：增加光线、把手机拿在 10–30cm 处并保持稳定、避开光面上的眩光。专用的二维码扫描器应用对临界码（小、磨损或低对比度）会有帮助，但如果某个码 只 能在专用应用里扫到，请把它当作一次失败的测试——您的客户用的是他们的相机。