我的二维码无法扫描

首先，把问题一分为二

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

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

原因 1：印得太小

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

小码是最常见的印刷失败，尤其在表面弯曲、起皱的纺织品上。每个二维码都有最小印刷尺寸，显示在二维码面板的下载按钮旁。织造、热转印和水洗标签通常需要比它更大。

解决： 按不低于该二维码最小印刷尺寸重印；织造或水洗标签应印得更大。尺寸预设和完整的印刷指引见 下载与打印二维码。

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

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

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

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

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

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

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

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

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

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

PassportCraft 的码以高纠错生成，因此即使码的一部分受损，仍可读取。但有些码在布料上仍会失败：印在接缝或折叠线上、印在严重起皱或磨损标签上、或在反光的光面下的码。

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

原因 5：护照是草稿

症状： 码能扫，打开了一个页面——但它显示 “This Digital Product Passport is not available”（此提示页面以英文显示）。GTIN 不匹配（原因 6）会显示同一条提示，所以请先排除这个原因。

二维码的 URL 永不改变，但它只在护照处于 已发布 状态时才解析到已上线的护照。草稿——包括一份曾经发布、随后被取消发布的护照——会改为显示这条中性提示，且不会暴露任何产品数据。您自己的团队从编辑器预览草稿，而不是从码：请从 护照管理 页面打开该护照，然后点击 预览。

一个例外：在护照还没有 GTIN 时下载的码编码的是护照的直接地址，而不是 GS1 Digital Link。这种码在您发布之前会显示 “This passport hasn't been published yet”，并附有 Sign in 链接（以最近一次发布所用的语言显示，从未发布过则为英文；此处为英文）。

解决： 检查该护照在 护照管理 页面上的状态标记。如果列表中根本找不到该护照，请到 回收站 查看——回收站中的护照会显示同一条提示。还原会让护照回到 草稿 状态，之后需要发布，码才会恢复工作。如果是 草稿，请发布该护照；已印好的码会立即体现这一变化——无需任何重印。如果是 已发布，请转到原因 6。

原因 6：GTIN 不匹配

症状： 页面显示 “This Digital Product Passport is not available”，且该护照在 护照管理 页面上的状态标记为 已发布。（草稿会显示同一条提示——原因 5。）

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

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

对于电池，请检查该电池的码：在单元页面打开该电池，查看其码所编码的地址。

相机应用与扫描器应用

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