Google Vision API人脸检测：faceDetector.isOperational()始终返回false

我之前也碰到过一模一样的问题，尤其是在旧版本的Play Services Vision上踩过不少坑，结合你的情况，给你几个针对性的排查和解决方法：

1. 先确认人脸检测模型是否成功下载 #

isOperational()返回false最常见的原因就是本地人脸检测模型没下载完成或者损坏了。虽然你在Manifest里配置了DEPENDENCIES的meta-data，但自动下载经常会因为网络、存储权限或者设备本身的问题失败：

• 先检查设备的网络连接，确保能正常访问Google服务（国内设备可能需要特殊网络环境）
• 确认App已经获取了WRITE_EXTERNAL_STORAGE权限（Android 6.0+需要动态申请），模型会下载到外部存储的Google服务专属目录里

2. 升级Play Services Vision版本 #

你用的10.2.4版本确实比较旧了，很多模型下载相关的bug在后续版本里都被修复了。建议直接升级到较新的稳定版本，比如：

implementation 'com.google.android.gms:play-services-vision:20.1.3'

升级后记得同步gradle，同时要确保测试设备上的Google Play服务也更新到对应版本。

3. 手动触发模型初始化，等待下载完成 #

有时候自动下载不会立刻生效，可以在App启动时提前初始化检测器，给模型下载留足时间，还能监听下载状态：

FaceDetector detector = new FaceDetector.Builder(context)
        .setTrackingEnabled(false)
        .setLandmarkType(FaceDetector.ALL_LANDMARKS)
        .build();

// 监听模型是否可用
detector.setProcessor(new Detector.Processor<Face>() {
    @Override
    public void release() {}

    @Override
    public void receiveDetections(Detector.Detections<Face> detections) {
        if (detector.isOperational()) {
            // 模型可用，执行你的人脸检测逻辑
        } else {
            // 模型还在下载中，可以给用户个等待提示
        }
    }
});

4. 清除Google Play服务缓存试试 #

如果之前的模型下载损坏了，试试这个操作：

• 打开设备「设置」→「应用」→「Google Play服务」→「存储」→「清除缓存」+「清除数据」
• 重启App后重新触发模型下载

5. 针对旧Android版本的特殊处理 #

你的测试设备是Android 5.1.1和6.0，这些旧版本容易有兼容性问题：

• 确保设备上的Google Play服务是当前能支持的最新版本（旧设备可能没法更到最新，但至少要匹配你用的Play Services Vision版本）
• 检查App的targetSdkVersion，别设置得太高导致旧系统不兼容

6. 再核对一遍Manifest配置 #

确认meta-data是放在<application>标签内部的，格式完全正确：

<application ...>
    <meta-data
        android:name="com.google.android.gms.vision.DEPENDENCIES"
        android:value="face" />
    ...
</application>

按照这些步骤排查下来，应该能解决isOperational()一直返回false的问题。

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