Android Camera2+MLKit预览时拍照无响应问题排查

核心问题点及修复方案 #

1. ImageCapture未正确绑定到CameraProvider #

Camera2的ImageCapture必须和预览、人脸检测用的ImageAnalysis一起绑定到CameraProvider的生命周期，否则拍照请求无法被相机会话处理：

// 初始化ImageCapture
val imageCapture = ImageCapture.Builder()
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
    .setTargetRotation(viewFinder.display.rotation)
    .build()

// 绑定所有相机组件到生命周期
cameraProvider.bindToLifecycle(
    this,
    cameraSelector,
    preview, // 预览组件
    imageCapture, // 拍照组件
    imageAnalysis // MLKit人脸检测组件
)

如果遗漏imageCapture的绑定，拍照时不会触发任何回调。

2. 拍照逻辑存在缺失或错误 #

• 检查按钮点击监听是否正确调用takePicture，且必须实现onError方法（否则出错无提示）：

captureButton.setOnClickListener {
    // 使用应用私有目录保存，避免权限问题
    val photoFile = File(filesDir, "JPEG_${System.currentTimeMillis()}.jpg")
    val outputOptions = ImageCapture.OutputFileOptions.Builder(photoFile).build()

    imageCapture.takePicture(
        outputOptions,
        ContextCompat.getMainExecutor(this),
        object : ImageCapture.OnImageSavedCallback {
            override fun onImageSaved(results: ImageCapture.OutputFileResults) {
                // 处理成功逻辑
            }

            override fun onError(e: ImageCaptureException) {
                // 打印错误日志，排查根本原因
                Log.e("CameraError", "拍照失败: ${e.message}", e)
            }
        }
    )
}

• 若未设置OutputFileOptions或文件路径无效，会直接触发onError，但如果没实现该方法就无法察觉。

3. 存储权限问题 #

• Android 10及以下需要WRITE_EXTERNAL_STORAGE权限，Android 11+若保存到公共目录需要MANAGE_EXTERNAL_STORAGE，但推荐使用应用私有目录（无需权限），避免权限申请遗漏导致保存失败。
• Manifest中需声明相机权限：

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

4. 自定义CameraSourcePreview的冲突 #

• 若CameraSourcePreview是自定义预览View，需确保：
  • 正确使用TextureView/SurfaceView承载预览，且Surface已传递给CameraProvider的预览组件；
  • 预览View未拦截拍照按钮的点击事件（比如设置了clickable=true但未处理，导致按钮点击无效）。

5. 相机资源冲突或会话异常 #

• MLKit的ImageAnalysis若配置不当，会占用过多相机资源，影响拍照请求：

val imageAnalysis = ImageAnalysis.Builder()
    .setTargetResolution(Size(640, 480)) // 降低分辨率减少资源占用
    .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST) // 只保留最新帧
    .build()

• 生命周期切换时需正确释放相机资源，避免会话异常：

override fun onPause() {
    super.onPause()
    cameraProvider?.unbindAll()
}

override fun onResume() {
    super.onResume()
    if (cameraProvider == null) {
        // 重新初始化CameraProvider并绑定组件
    }
}

快速排查步骤 #

1. 先实现onError回调并打印日志，直接获取错误原因；
2. 确认ImageCapture已加入CameraProvider的绑定列表；
3. 给拍照按钮的点击事件加日志，验证点击是否触发；
4. 改用应用私有目录测试拍照，排除权限问题。

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