Android CameraX拍照后偶现崩溃求助（三星Android11设备）

问题根源 #

该错误通常是由于ImageProxy（CameraX封装的图像对象）在未完成处理前被系统或CameraX提前回收关闭导致的。Android11的三星定制系统对图像资源回收机制更为激进，加上CameraX 1.2.3的兼容性问题，容易触发此异常。

解决方案 #

1. 同步处理图像数据，禁止跨线程传递ImageProxy #

CameraX的OnImageCapturedCallback回调结束后，会自动回收ImageProxy对象。如果将ImageProxy传递到其他线程处理，回调结束后对象已被关闭，就会触发异常。必须在回调线程内完成所有图像处理操作：

imageCapture.takePicture(ExecutorService.newSingleThreadExecutor(), object : ImageCapture.OnImageCapturedCallback() {
    override fun onCaptureSuccess(image: ImageProxy) {
        try {
            // 同步转换为Bitmap（必须在回调线程内执行）
            val bitmap = image.toBitmap()
            // 同步执行保存或其他处理逻辑
            saveCheckinPhoto(bitmap)
        } catch (e: IllegalStateException) {
            // 捕获异常，触发重试逻辑
            triggerRetryCapture()
        } finally {
            // 确保无论成功失败都关闭ImageProxy
            image.close()
        }
    }

    override fun onError(exception: ImageCaptureException) {
        // 处理拍照错误
    }
})

2. 调整ImageCapture配置，适配三星设备 #

修改ImageCapture的构建参数，降低资源占用并优化捕获模式：

val imageCapture = ImageCapture.Builder()
    // 使用低延迟模式，减少图像资源滞留时间
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
    // 设置合适的分辨率，避免高分辨率触发激进回收
    .setTargetResolution(Size(1920, 1080))
    // 关闭自动闪光灯（部分三星设备闪光灯触发会干扰图像生命周期）
    .setFlashMode(ImageCapture.FLASH_MODE_OFF)
    .build()

3. 异步处理需先复制图像数据 #

如果必须使用异步操作（比如上传照片），需先将图像数据复制到独立内存（如Bitmap或字节数组），再传递给异步任务，确保ImageProxy可以及时关闭：

override fun onCaptureSuccess(image: ImageProxy) {
    var bitmap: Bitmap? = null
    try {
        // 先复制图像数据到Bitmap
        bitmap = image.toBitmap()
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        // 立即关闭ImageProxy，释放资源
        image.close()
    }

    // 异步处理已复制的Bitmap
    bitmap?.let {
        Executors.newSingleThreadExecutor().execute {
            uploadCheckinPhoto(it)
        }
    }
}

4. 添加异常捕获与重试机制 #

针对三星设备的特殊情况，在捕获到IllegalStateException时，添加有限次数的重试逻辑，提升用户体验：

private var retryCount = 0
private val MAX_RETRY = 2

private fun triggerRetryCapture() {
    if (retryCount < MAX_RETRY) {
        retryCount++
        // 延迟100ms后重试拍照，避免连续触发资源冲突
        Handler(Looper.getMainLooper()).postDelayed({
            takeSelfie()
        }, 100)
    } else {
        // 重试失败，提示用户
        showToast("拍照失败，请重试")
        retryCount = 0
    }
}

额外注意事项 #

• 确保已正确申请CAMERA权限，Android11上若保存到应用私有目录，无需额外存储权限。
• 避免在拍照前后执行过多耗时操作，防止主线程阻塞导致图像资源回收异常。

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