ML Kit 的 play-services-mlkit-text-recognition 在 Android 8（Oreo）上返回空结果，主因是设备搭载的 Google Play 服务版本过低；升级至 23.13.12 或更高版本即可解决兼容性问题。
ml kit 的 `play-services-mlkit-text-recognition` 在 android 8（oreo）上返回空结果，主因是设备搭载的 google play 服务版本过低；升级至 23.13.12 或更高版本即可解决兼容性问题。
Google ML Kit 的文本识别（Text Recognition）功能依赖底层 Google Play 服务提供的原生模型与运行时支持。尽管官方文档未明确标注 play-services-mlkit-text-recognition 所需的最低 Play Services 版本，但实践表明：Android 8（API 26–27）设备对 Play Services 的版本敏感度显著高于高版本系统。使用 18.0.2 SDK 时，若设备预装的 Play Services 版本为 22.50.14（如问题中所述），OCR 引擎可能因 JNI 接口变更、模型加载逻辑调整或安全上下文限制而静默失败——不抛异常，仅返回空 Text 对象（即 result.getTextBlocks() 为空列表）。
✅ 验证与修复步骤如下：
-
检查当前 Play Services 版本（运行时）：
val isAvailable = GoogleApiAvailability.getInstance() .isGooglePlayServicesAvailable(this) if (isAvailable != ConnectionResult.SUCCESS) { // 提示用户更新 Google Play 服务 GoogleApiAvailability.getInstance() .getErrorDialog(this, isAvailable, 9001).show() } else { val versionCode = GoogleApiAvailability.getInstance() .getApkVersion(this) // 返回整型版本码，如 231312021 → v23.13.12 Log.d("MLKit", "Play Services version: $versionCode") } -
强制要求最低版本（推荐）：
在调用 TextRecognition.getClient() 前，添加版本校验逻辑：private fun ensureMinPlayServicesVersion(): Boolean { val minVersion = 231312000 // 对应 v23.13.12 return try { val current = GoogleApiAvailability.getInstance().apkVersion current >= minVersion } catch (e: Exception) { false } }
// 使用前校验 if (!ensureMinPlayServicesVersion()) { Toast.makeText(this, "请更新 Google Play 服务至 v23.13.12+", Toast.LENGTH_LONG).show() return }
3. **更新依赖（可选增强）**： 同步升级 SDK 至最新稳定版（截至 2024 年，推荐 `18.1.0` 或更高），其内部已适配新版 Play Services 接口： ```gradle implementation 'com.google.android.gms:play-services-mlkit-text-recognition:18.1.0'
⚠️ 注意事项：
- 此问题非 Android 8 系统缺陷，而是低版本 Play Services 缺少对 ML Kit 新 OCR 引擎（如 TextRecognizer v2）的兼容支持；
- 模拟器默认不包含 Play Services，务必使用真实设备或已安装 GMS 的模拟器（如 Pixel 3a + Google Play 系统映像）测试；
- 若无法强制用户更新（如企业定制 ROM），可降级至 text-recognition-common:17.0.1 + text-recognition-gpu:17.0.1（旧版 CPU/GPU 分离方案），但功能与精度会受限。
总结：ML Kit 在 Android 8 上的 OCR 失败，本质是 Play Services 版本鸿沟问题。将 com.google.android.gms 升级至 23.13.12（版本码 231312021）及以上，是最直接、可靠且无需修改业务逻辑的解决方案。
