二维码识别失败，通常不是扫码工具单方面的问题，而是二维码图像里的定位点、模块边界或白边已经不够清楚。
常见原因
| 问题 | 表现 | 处理建议 |
|---|---|---|
| 图片模糊 | 黑白格边缘发灰 | 使用更清晰原图或像素无损放大 |
| 分辨率太低 | 二维码很小 | 按整数倍放大，不要非等比例拉伸 |
| 白边缺失 | 贴着图片边缘 | 重新导出或裁剪时保留 quiet zone |
| 对比度不足 | 前景和背景太接近 | 换成深色前景和浅色背景 |
| 压缩过度 | 出现色块和噪点 | 使用 PNG 或更高质量导出 |
| 内容太长 | 二维码非常密 | 缩短内容或使用短链接 |
先确认图片本身是否可解码
如果你不确定问题出在二维码还是扫码 App，可以先用二维码解码工具上传原图，看能否解析出文本。能解析说明二维码内容本身还在，不能解析再考虑修复图片质量。
提高识别率的实用方法
- 尽量使用原始 PNG 或高清截图，不要用被社交软件多次压缩的图片。
- 放大时选择像素无损模式，二维码更适合硬边放大。
- 不要裁掉二维码四周白边，白边是识别定位的一部分。
- 打印前做真实距离测试，避免尺寸太小。
- 如果二维码内容很长，优先改成短链接再生成。
按顺序排查，避免盲目美化
- 先用原图解码，记录是否每次失败、偶尔失败，还是只有某一台设备失败。
- 确认三个定位方块完整，模块没有被非等比例拉伸，四周仍有连续浅色静区。
- 转成灰度观察前景与背景是否仍清楚，复杂底图和半透明模块会破坏二值化。
- 如果只在打印后失败，检查物理尺寸、打印网点、反光、折痕和实际扫码距离。
- 如果图像能解码但手机没有执行动作，问题在 payload 格式或内容，不在二维码图形。
纠错等级不是万能修复
二维码纠错可以在部分模块受损时恢复数据，但定位方块、时序结构、静区或大量连续区域被破坏时，增加纠错等级也无法补救。较高等级还会让相同内容需要更多模块，若输出尺寸不变，单个模块反而更小。设计阶段应同时控制内容长度、纠错等级和最终尺寸。
已经模糊或严重压缩的二维码无法凭空恢复确定的原始模块。像素无损整数倍放大只方便扫描器观察现有边界，不会创造丢失数据；锐化和 AI 放大还可能把错误边缘变得更确定。重要二维码应回到原始 payload 重新生成，而不是反复修图。
总结
二维码要能识别，关键是清晰边界、足够尺寸、完整白边和高对比度。修复时先保留结构，再考虑美化。