uni.scanCode识别率低本质是ZXing库能力不足，iOS/Android需换支付宝mPaaS插件，H5端必须用html5-qrcode+HTTPS，禁用闪光灯检测和自动对焦可显著改善低端机表现。
uni.scanCode 在 iOS/Android 上识别率低，本质是原生扫码库能力边界问题
uni.scanCode 底层用的是 ZXing 开源库，不是微信/支付宝那种商业级引擎。它在标准清晰码上表现尚可（98%），但遇到带 Logo、轻微模糊、弱光、小尺寸二维码时，成功率直接掉到 40–65%，这不是你参数没调对，而是算法本身没做多尺度检测、自适应增强和动态 ROI 裁剪。iOS 上尤其明显——系统相机流进不来或帧率被压制，导致画面糊、对焦卡顿、反复失焦。
App 端优先换支付宝扫码插件，别碰 autoDecode 和 autoZoom
实测支付宝 mPaaS 扫码插件在模糊码、弱光、带 Logo 场景下成功率稳定在 92%+，速度提升 2.5–3.2 倍。关键不是“加功能”，而是替换底层引擎：
-
autoDecode: false和autoZoom: true这类参数在 uni.scanCode 里反而会拖慢帧率，尤其在联发科安卓 9–10 设备上，禁用后卡顿明显缓解，但识别率不升反降——说明优化方向错了 - 必须走原生插件路径：
Mpaas-Scan-Module，配置AppID、WorkspaceID、License三要素缺一不可，漏一个就 fallback 到默认uni.scanCode - 插件调用后不返回
res.result，而是ret.resp_result，且失败码是ret.resp_code（10= 用户取消，11= 其他错误），直接按官方文档字段名取值会报 undefined
H5 端必须放弃 uni.scanCode，用 html5-qrcode + HTTPS 强约束
uni.scanCode 在 H5 下根本不会触发摄像头，浏览器直接静默拒绝。真实可行路径只有一条：
- 运行环境必须是 HTTPS（
http://localhost可临时调试，但上线必 HTTPS） - 用
html5-qrcode替代所有自研 canvas + zxing.js 方案，它内置 WebAssembly 加速和多引擎 fallback（ZXing + QrScanner） - 关键配置项：
fps: 15（设太高耗电卡顿，太低漏帧）、disableFlip: true（禁用镜像，避免扫码框错位）、qrbox: { width: 250, height: 250 }（显式裁剪 ROI，聚焦中心区域） - iOS Safari 对
getUserMedia权限更敏感，首次扫码前需用户主动点击触发，不能 onload 自动拉起
安卓低端机对焦慢？关掉闪光灯检测比调参更有效
部分安卓机型（如红米 Note 9、vivo Y 系列）调用 uni.scanCode 后持续“咔哒”对焦声、画面抖动、3 秒无响应，不是代码问题，是 DCloud 默认启用了闪光灯状态轮询 + 自动对焦策略，严重挤占主线程。解决方式非常直接：
- 不依赖任何“优化参数”，直接在 manifest.json 的 “App 模块配置” → “Barcode（条码）” 模块里，把 “启用闪光灯检测” 和 “启用自动对焦” 两个勾选项全部取消
- 保留
scanType: ['qrCode']显式限定类型，减少解码干扰 - 失败时 err.errMsg 多为
scanCode:fail system error，无法区分是光线弱还是权限拒，必须配合 UI 提示：“请打开灯光，将二维码放满扫描框”
真正影响识别率的从来不是“要不要加个 debounce”，而是你用的到底是 ZXing 还是支付宝同源引擎；不是“怎么调 fps”，而是你有没有意识到 H5 必须 HTTPS、iOS Safari 必须用户手势触发。这些点一旦漏掉，再精细的参数调优也只是在边缘打转。
