二维码扫不出来，常见原因不是生成失败，而是尺寸太小、留白不足、对比度太低、内容过长或目标链接不可访问。发布前应在真实设备和真实距离下测试。
尺寸和留白决定基础可扫性
二维码四周需要保留空白边界，通常称为 quiet zone。海报、名片、包装或屏幕截图里如果贴得太靠边，扫码器很容易识别失败。
印刷物上二维码不能只看屏幕预览。实际尺寸、观看距离、纸张反光和打印精度都会影响识别，发布前最好用多部手机实测。
对比度和颜色不要过度设计
深色码点配浅色背景最稳定。低对比度、渐变、复杂底图、透明背景或反色设计，都可能让某些扫码 App 失败。
加入 Logo 时应控制面积，并选择合适容错率。Logo 过大或遮挡关键区域，会让二维码在低清晰度场景下变得很脆弱。
内容越长，二维码越密
长链接、很多参数或大段文本会让二维码格子变密，对打印尺寸和摄像头清晰度要求更高。营销链接可以先清理参数，必要时使用稳定短链。
二维码本身通常不会过期，但它指向的网页、短链、活动页、文件权限或服务器可能过期。扫不出来和扫出来打不开，是两个不同问题。
发布前的快速检查
用目标用户可能使用的手机、扫码 App 和距离测试；确认链接支持 HTTPS、移动端可打开、不会跳到登录失败页；打印后再扫一次实体样张。
如果二维码会长期使用，应保存原始内容和生成参数，并避免绑定临时链接。线下物料一旦印刷，修复成本会明显高于线上替换图片。
立即处理
使用相关工具
常见问题
关于这个问题
二维码会过期吗？
静态二维码不会自己过期，但其中的链接、短链、文件权限或活动页面可能失效。
二维码中间可以放 Logo 吗？
可以，但要控制大小、保持足够对比度，并提高容错率后实测。重要场景不要让 Logo 遮挡过多码点。