二维码扫不出来怎么办（以及怎么修）：完整排错指南

二维码扫不出来的原因其实就那么几种，而且都很好理解。把这份指南从头读到尾，95% 的扫码问题你都能在五分钟内自己搞定。

有一个思考框架挺有用：每个二维码，都是三方之间的一份默契——印出来或者显示在屏幕上的码、想扫它的那部手机，以及这个 URL 最终指向的服务器。其中任何一方“掉链子”，扫码就会失败。

这份指南按“谁的锅”来组织。绝大多数问题出在码本身，所以我们先从这里讲起。

快速诊断：30 秒搞清楚是谁的问题

深入排查之前，先做这一组小测试：

1. 试一个你确认能用的码。打开任何一个你以前扫过、确定能用的动态码，扫一下。能扫——说明你的手机没毛病。
2. 用别的手机扫这个出问题的码。借一部别人的手机。别人能扫到——是你这部手机的问题；两部都扫不出来——是这个码本身的问题。
3. 换个亮一点的环境再试。把码拿到窗边或台灯下扫。这时候能扫了——问题出在光线或对比度上。
4. 如果码旁边印有 URL，手动输入试试。把 URL 敲进浏览器。页面能打开——说明目标地址没事，码本身有问题；页面打不开——是目标地址挂了，码无辜。

哪一步指向了问题，就直接跳到下面对应的章节去看。

问题 1：码被物理损坏了

二维码本身带有容错能力。在最高容错级别下，大约 30% 的图案被遮挡或损坏，码还是能扫出来。但“30%”是最高级别下的极限——很多实际生成的码用的是较低的容错级别，能承受的损伤要小得多。

常见的“受伤”情况：

• 码上有折痕、压痕
• 咖啡渍、水渍、食物污渍
• 被刮花，墨层脱落
• 被太阳晒褪色
• 贴纸或标签盖住了一部分
• 印刷瑕疵（条纹、错位、糊版）

怎么修：

• 轻微损伤（遮挡不到 10%）的情况下，大多数现代手机相机还是能识别。试试换角度、换距离再扫。
• 损伤比较严重的话，只能重新打印。如果是动态码——好办，印一张新的就行；如果是静态码，URL 是直接编进图案里的，所以印一张相同的码就能恢复使用。

怎么预防：高频使用的位置，务必用耐用的材质来印。覆膜、亚克力立牌、防水 PVC 这些都能让码多撑好几年。户外环境的话，抗 UV 油墨那点额外成本绝对值。

问题 2：印得太小

二维码得够大，相机才能看清楚组成图案的每一个小模块（那些小黑方块）。

一条通用经验：

最小尺寸 = 扫描距离 ÷ 10

30 厘米外（伸手能到的距离）扫的码，至少要 3 厘米；3 米外（墙上的海报）要扫的码，至少要 30 厘米。

常见场景下的最小尺寸参考：

• 名片 / 桌面立牌：最小 2.5–3 厘米
• 杂志广告 / 传单：3–4 厘米
• 店铺橱窗：5–8 厘米
• 室内距离的海报：10–15 厘米
• 跨房间扫的大海报：20–30 厘米
• 户外广告牌：看观看距离，可能要超过一米

怎么修：如果码已经印得勉强够大，赶紧重新印大一点的版本。如果已经大批量印出去了，基本只能想办法让用户更靠近物料——但这通常不现实。

怎么预防：量两次，印一次。大批量印刷之前，务必在真实的使用环境里，用真实的印刷尺寸先测一遍。

问题 3：对比度不够

二维码扫描最稳的状态是：深色方块非常深、浅色方块非常浅。中间的对比度要足够高。

常见的对比度翻车场景：

• 中灰色的码印在白色背景上
• 深色码印在深色背景上
• 对比度不够的彩色码（尤其是马卡龙色调）
• 白色码印在黑色背景上（多数现代手机能扫，部分老 Android 不行）
• 码上叠了半透明的遮罩
• 印在带纹理或彩色的纸上，颜色渗到模块里

怎么修：

• 用更高的对比度重印一次。黑底白码是最保险的组合。
• 如果出于品牌需要必须用彩色，用非常深的颜色（深海军蓝、墨绿、勃艮第红）配非常浅的底色。
• 如果码必须放在彩色表面上，在码周围加一圈白色面板。

怎么预防：务必在真实的纸张/材质上，在真实的光线条件下，测试真实印出来的码。设计师校准过的显示器上看着漂亮的稿子，放到灯光昏暗的餐厅里，往往就扫不出来。

问题 4：反光、眩光

光面纸、覆膜、塑料包装、亮面亚克力立牌都会反光。反光打到镜头里，相机就看不清码了。

怎么修：

• 把手机往一边倾斜 15–20 度。这样既能避开反光，相机又能看清码。
• 换个站位，让光源在你身后，而不是码的背后。
• 对光面材质上的码，如果可以，把头顶的灯调暗一点。

怎么预防：强光环境下不要用高光泽工艺来做二维码。哑光或绒面表面要友好得多。

问题 5：目标 URL 挂了

有时候码本身扫得很顺，但它指向的 URL 返回 404（或者“无法访问此网站”），用户就以为码坏了。

常见原因：

• 目标页被搬走或删掉了。
• 生成码的时候 URL 打错了。
• 网站临时挂了。
• URL 里有拼写错误或多了一个空格。
• URL 里有需要 URL 编码的特殊字符。

怎么修：

• 如果是动态码：登录二维码服务商后台，把目标 URL 改一下，同一个码立刻指向新的地址，不用重印。这就是动态码最厉害的地方。
• 如果是静态码：URL 是写死在码里的，改不了。你能做的只有两件事——拿正确的 URL 重印一遍，或者在自己服务器上把原 URL 做成一个跳转。

怎么预防：生成码的当下立刻测一遍目标 URL，页面上线后再测一次。网站结构变动时，养成顺手检查码的习惯。

问题 6：动态码过期或被禁用了

这是最让人头疼的一种失败，因为码本身完全没问题——只是服务商的服务器不再为它做跳转了。

常见原因：

• 你在二维码服务商的免费试用结束了。
• 你取消了订阅或者降级了，而这家服务商的政策就是取消后停掉动态码。
• 账户因为欠费被暂停。
• 服务商倒闭了。
• 服务商因为长期不活跃删掉了这个码（少见但确实发生过）。

怎么修：

• 登录二维码服务商账户。如果码被暂停或禁用了，把它恢复——通常意味着重新订阅。
• 如果服务商已经关停，或者账户没了，只能换平台重新生成新码，然后重印。

怎么预防：这正是为什么要选一家“取消订阅后码不会失效”的二维码服务商。QR Cake 的政策是：即使取消订阅，码也会继续跳转到最后一次保存的目标地址。但大多数付费服务商会在订阅结束后直接停掉码。把已经印好的物料押在某家服务商之前，务必看清楚条款。

问题 7：手机相机的问题

没有大家想象的那么常见，但确实会发生。

常见的手机端问题：

• 镜头脏了。用超细纤维布擦一下。这一个操作，修好的“坏码”比其他任何方法都多。
• 用错相机 App 了。有些 Android 厂商手机自带不止一个相机 App，确保用的是支持扫码的那一个标准相机。
• 相机设置里把扫码功能关了。部分三星和小米手机会把这个选项藏在 设置 → 相机 → 扫描二维码 里。
• 处于不支持扫码的拍摄模式。自拍模式扫不稳，有些“专业”模式也不行。用标准拍照模式。
• 系统太老。iOS 11 之前、Android 8 之前，系统没有原生扫码能力。

怎么修：用另一部手机扫一下这个码，或者装一个靠谱的第三方扫码 App(Android 上推荐 TeaCapps QR & Barcode Scanner;iPhone 用自带相机，或者控制中心里的“扫码器”）。

问题 8：码太密

这是一个生成端的小坑，很容易被忽视。静态码里编的数据越多，图案就越密。短 URL 生成出来的码稀疏好扫；带一长串 UTM 参数的长 URL 生成出来的码，又密又脆，稍微一点损伤就扫不出来。

怎么修：

• 静态码的话，生成之前把 URL 缩短一下。用短链接服务，或者把 UTM 追踪挪到服务器端去做。
• 更好的办法：直接切到动态码。动态码不管最终目标 URL 多长，编进去的都是一段短跳转，图案稀疏、容错好，小尺寸下也扫得稳。用 QR Cake 免费做一个动态码，是验证“是不是密度问题”的快办法——同样的目标地址，用动态码再做一个，跟原来的静态码并排比一下就知道了。

怎么预防：如果码要印得小，就千万别把长 URL 塞进静态码。批量印之前，务必在计划的实际尺寸下测一遍。

问题 9：位置没放对

就算码做得完美、印得完美，放错位置一样会扫不出来。

常见的“位置不对”：

• 放在反光玻璃后面（博物馆展柜、带框海报）
• 放在曲面上（柱形包装、易拉罐）
• 放在会让图案变形的织物或针织面料上
• 光线只能照到码的一侧
• 用户必须从一个让相机里图案变形的角度去扫

怎么修：把码挪到一个平整、光线好、容易接近的位置。批量印之前，务必在真实位置上测一遍。

怎么预防：把“放在哪里”当作设计的一部分去考虑，而不是事后补的一个步骤。

问题 10：颜色反转

二维码的设计原则是“深色模块 + 浅色背景”。反转配色的码——浅色模块 + 深色背景——在现代 iPhone 和较新的 Android 上能扫，但很多老设备就不行。

怎么修：实际印刷的时候，还是用深色方块 + 浅色背景。设计稿上是反色没关系，生产版务必回到常规配色。

怎么预防：如果出于设计原因实在需要浅色码 + 深色背景的视觉效果，在最终决定之前，务必拿一堆老款 Android 测过。很多老 Android（尤其是低端机型）是真的扫不出反转配色的码。

批量印之前，该怎么测

在打算印 1000 张之前，先花 10 分钟做这个测试：

1. 用计划中的实际尺寸，打印一张样码。
2. 用 iPhone（自带相机）扫。
3. 用 Android 手机（自带相机或 Google Lens）扫。
4. 从用户可能最近的距离扫。
5. 从用户可能最远的距离扫。
6. 挪到这个码将来所在环境里最暗的角落，再扫一次。
7. 至少找一部跑着老系统的手机测一下（条件允许的话，iOS 14 或 Android 9）。
8. 打开目标 URL，确认它在手机上 3 秒内能加载出来。

任何一步失败，先解决了再去大批量印。

常见问题

同一个码，为什么这部手机能扫，那部就不行？通常是三种情况之一：能扫的那部手机摄像头光学更好，软件层面的扫码识别更先进（系统更新），或者你拿手机的距离/角度不一样。用扫不出来的那部手机，试一下上面相机一章里的建议。

我的码昨天还好好的，今天突然扫不了，为什么？三种可能，按概率从高到低排：（1） 目标 URL 改了或者报错；（2） 动态码的订阅到期了；（3） 码被物理损坏了。

静态码能不重印就修好吗？码本身改不了——URL 已经写进图案里了。但如果你能控制目标 URL 所在的域名，可以在服务器端把这个 URL 做成一个跳转，跳到新地址。这样印出去的码就能继续用。

有些码扫一下就开，有些要等几秒，为什么？那些一下就开的码，对比度高、印刷质量好、尺寸合适、数据图案稀疏（通常是短 URL）。慢的那种，通常是这几项里有一项或几项没做好，手机得费更多力气才能把它读出来。

容错级别会影响扫码吗？会的。容错级别越高（L、M、Q、H,H 最高），码越能容忍损伤，但图案也越密。大多数生成器默认用 M（中等），日常使用够了。户外或工业场景，建议调到 Q 或 H。

iPhone 能扫的码，老 Android 是不是经常扫不了？是的，经常这样。iPhone 的扫码能力通常比中端及更老的 Android 强。如果你是面向公众做码，优化目标应该按观众里最弱的那种合理设备来——通常就是老 Android。

彩色二维码是不是更不可靠？本质上不是。可靠性看的是对比度，而不是颜色本身。白底上的黑码和白底上的深海军蓝码效果一样好；白底上的浅黄色码就很差。用之前测一下。

为什么我的码白天能扫，在餐厅灯光下就扫不了？光线强弱会影响相机的对焦速度，也会影响码在相机里的实际对比度。光线暗时，相机对焦更慢，看到的对比度也比白天弱。更大的码、更高的对比度、更不反光的表面，在昏暗环境下表现都会更好。

都试过了还是不行？

如果你把这份指南从头到尾走了一遍，码还是扫不出来，那基本就是下面三种情况之一：

• 码生成时参数有问题（少见但会发生——重新生成一下试试）
• 服务商那边出故障了（查一下他们的状态页）
• 目标服务器宕机或者拦截了你的访问

如果都不是，那这个码可能有点细微的生产缺陷。最快的办法是：找一个靠谱的服务商重新生成，重新印一次。

免费创建一个新的动态二维码