二维码故障排查，从头到尾

扫不出来的二维码很少是个谜。大多数失败归结为十一种原因之一，并且可以分成三个问题：图案读不出来吗，手机吃力吗，还是码扫得好好的、目标让人失望了？先回答这些，你就不会重印一个没问题的码——也不会在链接死了的时候去修图案。

先查这三项

1. 换另一部手机试试。如果另一部手机能读出码，图案没问题。跳到下面的手机检查项。
2. 看码本身，别看屏幕。它小吗、淡吗、被附近文字挤占吗、被 Logo 盖住了吗、刮花了吗、褪色了吗？其中任何一项都能让图案读不出来。再试一份原始文件的新副本：如果新副本能扫，失败的是原来的印刷品，不是数据。
3. 读扫码返回的东西。如果手机认出了码，但页面一直加载不出来或者落到了意料之外的地方，图案完成了它的任务。问题在目标页面：被删的页面、打错的链接，或者被关掉的动态码。

一个区分贯穿始终：从来不扫的码有图案或相机问题，而有时扫的码——强光下能扫、暗光下不能，凑近能扫、一臂距离不能——是个勉强过关的码。勉强过关的码在你的桌上能过、到了顾客手里会失败：把时灵时不灵的码当成坏码处理。

原因表：所有常见失败一览

图案本身：码变得读不出来的六种方式

1. 对扫码距离来说太小

小码失败是因为相机在画面里模块很小时分辨不出单个模块——就是那些小方块。经验法则，印刷码保持至少 2 × 2 cm，并且随距离放大：码的宽度至少要是预期扫码距离的十分之一。50 cm 外扫的桌卡需要约 5 cm 宽的码；5 米外扫的海报需要约 50 cm 宽的码。装着长链接的数据密的码比短链接需要更多空间。完整的尺寸表见打印尺寸指南。

2. 发糊或分辨率低

发糊意味着像素太少、摊的面积太大，模块边缘糊成一片。常见元凶是低分辨率导出、让锐利边缘变软的 JPEG 保存、截屏的截屏，或者不成比例拉伸文件导致方块变成长方形。在源文件上修：重新导出为高分辨率 PNG，或者导出为 SVG——它放大不发糊——调整尺寸时只等比例缩放。已经发糊的印刷品没法锐化回来——用干净文件重印。五种原因和修法见二维码为什么发糊。

3. 对比度低

扫码器要找浅色底上的深色模块。白色上的浅灰、淡彩品牌色、压在照片上的码，或者深色底上的深色模块，都会拿掉相机需要的差别。这是最常见的设计导致的失败，也是最能避免的：黑白搭配永远管用，任何颜色搭配都应该在黑白下依然能读。注意反色码和压在花哨图片上的码，背景会在那里跟图案竞争。如果码在强光下能扫、在暗房间里不能，对比度就是第一嫌疑。

4. 静区被挤占或裁掉

码周围的空白边不是装饰。扫码器靠它找到图案的边缘，标准规定静区至少 4 个模块宽——就是码自己的小方块的 4 个——四边都要，按 ISO/IEC 18004 定义。文字或图案挤进这个边距会干扰识别，手机永远读不到数据。这种失败容易被错过，因为码本身看着完美。用盖住码周围一切的办法测试：如果扫得干净，就恢复边距并保持它空着。

5. Logo 盖住了太多图案

中间 Logo 能成立，只是因为纠错把被盖住的数据补回来了。ISO/IEC 18004 定义了四档纠错级别——L、M、Q、H——大约能恢复的码字分别是 7%、15%、25% 和 30%。这些百分比说的是码字的恢复，不是你能盖住的可见面积的有保证份额。经验法则，Logo 保持小——打印尺寸指南建议控制在码面积的约 30% 以内——用最高的纠错级别，比素码印大一点，永远别盖住三个大的角方块，扫码器需要它们来定向图案。先在两部手机上扫码测试。见怎么给二维码加 Logo和带 Logo 的二维码生成器。

6. 破损、脏污和褪色

折痕、划痕、洒渍、褪色和磨旧的贴纸都会吃掉图案，纠错只能补回来这么多。角方块的损伤尤其致命：没有它们，扫码器根本定位不了码。对真实世界的码——菜单、标签、户外招牌——预防胜过修复：表面覆膜、选更高的纠错级别、多印一份备用，先检查最旧的副本。如果图案本身已经磨没了，用原始文件重印，别修修补补破损的副本。

目标页面：码扫出来了，但没发生好事

一次返回错误页、缺失页或意料之外的落地页的扫码，是对一个坏掉的目标的成功扫码。在电脑上打开链接，逐字读它：搬家或被删的页面、打错的地址、挂掉的网站，或者主人改了目标的短链接，都是常见原因。

一个结构上的版本决定了修复是不是可能。静态码把目标直接装在图案里，所以只要链接在，它就工作——链接死了，只有它背后的页面能恢复，或者码重印。动态码装的是一个短跳转，所以主人不用重印就能改目标——但码于是依赖那个账号和服务保持活跃。账号过期或者服务关掉跳转，印好的码就不再通向任何有用的地方，哪怕图案完美无缺。这就是大多数“我码过期了”故事背后的机制，见二维码会过期吗？。重印之前先查目标能不能恢复或改指向。

手机和那一刻：权限、对焦、光线和屏幕

• 相机权限。从来没给过相机访问权的扫码器什么都看不见。允许相机访问，再试一次。FreeQrly 的扫码器在你自己的设备上的浏览器里解码——见扫码器页面——但浏览器仍然需要打开相机的许可。
• 镜头脏了。用软布擦镜头。糊掉的镜头模糊的正是二维码由之构成的精细细节。
• 对焦和距离。手机拿稳，整个码和它的静区都保持入镜，慢慢移动直到对焦锁定。很近不一定更好：大多数相机在几厘米外对不上焦。
• 光线和反光。光面覆膜、屏幕或聚光灯会把光反射回相机、洗掉模块。倾斜码或手机，离开直射光，或者换哑光面。倾斜时跟着动的反光是反光，不是损伤。
• 弯曲或倾斜的表面。包在瓶子上的码或者陡角度拍的码是变形的，扫码器对变形的容忍是有限的。能展平就展平，拍摄尽量正面。
• 自己手机屏幕上的码。你没法把手机相机对着它自己的显示屏。对同一部手机上照片、截屏或消息里的码，改解图片文件：iPhone 上在相册里长按码；安卓上在相册里用 Lens；电脑上上传到解码器，比如 FreeQrly 的扫码器。完整步骤见怎么从图片扫二维码，各手机相机步骤见怎么在手机上扫二维码。

苹果自己的指南确认了基准：iPhone 上，打开相机 App 或控制中心里的扫码器，让码出现在画面里，点出现的链接。如果这条路对别的手机能读的码毫无作用，怀疑权限、对焦和光线——不是缺一个扫码 App。iPhone 和安卓的通用步骤见怎么扫二维码。

按场景：印刷、屏幕和户外

印刷码：传单、名片、菜单、包装

印刷失败通常按顺序是尺寸、分辨率、对比度或磨损。按最终尺寸测试，别在屏幕上测：印一份，退到真实观看距离，用两部手机扫。在成品排版里检查静区，不只在预览里检查，因为排版工具会裁掉边距。经手的码覆膜，原始导出文件留着。

屏幕上的码：幻灯片、电视、视频通话、网站

屏幕码败在反光、刷新闪烁和相对于观看者距离的尺寸上。幻灯片上的码做大一点，在屏幕上停留几秒而不是一闪而过，别把它放在移动背景上。手机对手机显示时，调亮屏幕、背对头顶灯光倾斜。

户外码：海报、招牌、车辆、商店橱窗

户外码同时面对所有失败：距离、阳光、反光、天气和褪色。按十分之一法则慷慨地放大，哑光纸上印高对比度，做好防风雨，在真实路人距离和角度下测试。商店橱窗码需要特别检查：在白天从玻璃外面扫，因为从里面看不见的反光能把码洗掉。

老实对比：免费码、付费码和“过期”码

任何老实生成器的静态码都有同一个属性：目标就刻在图案里，所以没什么会过期、没什么要续费、没有账号过期后连累码。FreeQrly 的静态码免费，不用注册、没有水印、永不过期。给静态码付费买不到关于它寿命的任何东西：为一个从来不需要服务器的码付订阅，不是让它活着。

动态码是另一种产品，老实的交易是这样的：你得到印后编辑和扫码统计，接受对一个账号和一项服务的依赖。FreeQrly 的动态码免费起步——登录，你就得到 20 个免费动态码，限时活动期间目前不限量——带编辑、统计和扫码不限。即使零价格，依赖也是真实的：删掉账号，码也跟着没了，所以一个必须比主人活得久的目标的唯一副本，永远不应该是动态码。对任何必须零维护长久存在的东西——WiFi 密码、名片、牌匾——静态在结构上更安全。

同样的逻辑适用于别处的付费动态码：一个停工时，图案几乎从来不是问题——订阅、账号或跳转才是。重印之前，先查厂商的 Dashboard、账号状态和跳转指向的目标。对一批没法便宜重印的印刷品，先问一句：如果我停付，印好的码还工作吗？答案告诉你，你买的是一个码，还是在租一个码。

重做、重印，还是修目标？

• 修目标，当码能扫、但页面不对或不见了，而且你掌控页面或跳转时。不用重印。
• 用原始文件重印，当新副本能扫、装好的副本不能扫时：印刷、表面或位置失败了。
• 重做码，当新副本也失败、数据错了，或者设计——尺寸、对比度、Logo、边距——有问题时。生成一个干净的码，在两部手机上测试，然后再印。
• 换码的类型，针对反复出现的结构性失败：会变的目标属于动态码；绝不能依赖账号的属于静态码。

如果一个码在两部手机上，用新鲜、够大、黑白分明、边距清晰的印刷品还是失败，怀疑数据本身——过长的链接，或者打错的地址。缩短链接，重新生成。

做一个干净的替代品

当结论是“重做”时，从干净的导出文件开始，别修修补补旧文件。在免费生成器里生成替代品——全部 17 种内容类型都有静态码，不用注册，登录后免费动态码带编辑和统计。如果码需要 Logo，用Logo 生成器，Logo 保持小、纠错级别用高；如果一次需要很多码，批量生成一个链接出一个码。印刷之前，用扫码器和第二部手机测试。上面链接的深入阅读——一步一步诊断、发糊修复和打印尺寸指南——各自把一个原因讲得更深。