为何MLKit条码（二维码）扫描器在部分Android设备上扫描速度缓慢？

核心原因 #

• 依赖版本兼容问题：当前集成使用的CameraX 1.1.0-beta03 为测试版本，在小米、Pixel等对相机硬件抽象层做了定制修改的设备上，存在帧输出参数异常的问题：包括帧分辨率超出推荐值、旋转角度元数据错误、YUV格式stride偏移计算不准。MLKit的条码检测模型对输入帧的参数一致性要求高于ZXing，参数异常会导致模型反复执行无效检测，直接拉长识别耗时。三星设备的相机HAL层对CameraX的适配更完善，因此未触发这类问题。
• 检测配置冗余：当前使用的barcodeScanning 17.0.2 版本默认开启全条码格式检测，会同时匹配十余种一维码、二维码格式，检测链路长。而ZXing嵌入式BarcodeView默认优先匹配高频QR码格式，单帧检测耗时更短。未手动限定检测格式时，在中低端算力设备上，单帧检测耗时会是限定格式场景的3-5倍，很容易出现长时间无法识别的情况。
• 帧调度逻辑缺陷：MLKit条码检测为异步执行逻辑，如果ImageAnalysis未配置正确的背压策略，CameraX会持续将新的相机帧送入分析队列，前序帧未完成检测就会被后续帧积压，最终送入检测模型的永远是滞后数秒的旧帧，严重时会出现队列阻塞、完全无法返回结果的问题。ZXing的BarcodeView默认采用同步检测+丢帧策略，仅处理最新的相机帧，不存在队列积压问题，因此识别速度更稳定。
• GMS服务依赖问题：如果使用的是GMS动态绑定版本的MLKit条码扫描组件，在小米等搭载定制版GMS、GMS版本较低的设备上，会出现运行时动态下载模型、自动降级为低效CPU推理的情况；Pixel设备如果GMS服务后台运行异常，同样会触发推理性能下降。三星设备通常预装完整匹配版本的GMS，因此运行状态稳定。

修复方案 #

• 替换CameraX为正式稳定版本，将camerax_version升级到1.2.3及以上，配置ImageAnalysis时采用STRATEGY_KEEP_ONLY_LATEST背压策略，仅向检测链路推送最新帧，同时将目标检测分辨率设置为1280*720，避免过高分辨率带来的性能损耗，参考配置代码：

val imageAnalysis = ImageAnalysis.Builder()
    .setTargetResolution(Size(1280, 720))
    .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
    .build()

• 显式配置条码扫描器仅检测QR码格式，缩小检测范围，降低单帧检测耗时：

val barcodeOptions = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_QR_CODE)
    .build()
val barcodeScanner = BarcodeScanning.getClient(barcodeOptions)

• 传入检测帧前，根据相机传感器方向、当前设备屏幕方向手动计算准确的旋转角度，传入InputImage构造方法，不要依赖MLKit的自动旋转校正，避免方向错误导致的无效检测。
• 如果需要兼容GMS版本低、无GMS服务的设备，替换为MLKit静态绑定版本的条码扫描组件，将检测模型直接打包进APK，避免运行时下载模型、动态降级带来的性能波动。

内容的提问来源于stack exchange，提问作者Jean Wittmann