Android Camera2 API无法获取输出缓冲区问题排查及解决咨询

这个问题我之前维护Camera2相关项目时也碰到过，结合你描述的场景和Android 6.0（API23）的特性，来拆解下原因和对应的解决思路：

可能的原因 #

1. 图像缓冲区未及时回收 #

Android 6.0的Camera2 API对输出缓冲区的生命周期管理要求非常严格——哪怕你克隆了缓冲区，只要原始Image对象没正确调用close()，或者克隆后的像素数据没及时释放，都会耗尽缓冲区池的可用资源。当系统尝试获取新缓冲区时无资源可用，就会触发3000ms的超时等待，最终抛出getBuffer: wait for output buffer return timed out错误。

2. 后台线程调度冲突与处理瓶颈 #

你用了两个后台线程（Camera处理线程+OpenCV处理线程），如果OpenCV线程的CPU优先级过高，或者图像处理逻辑（比如OpenCV的滤波、特征提取）耗时过长，会挤占Camera框架线程的CPU时间，导致CameraCaptureSession的请求处理延迟，进而引发请求队列积压和缓冲区超时。另外，即便你限制了同一时间仅运行一个处理线程，未完成的任务也会间接持有缓冲区资源。

3. 捕获帧率与处理能力不匹配 #

setRepeatingRequest会以相机默认帧率持续发送捕获请求，如果你的图像处理速度跟不上这个帧率，哪怕部分图像被舍弃，未处理的Image对象若没及时关闭，依然会占用缓冲区，最终导致缓冲区池彻底耗尽。

对应的解决方法 #

1. 严格管理缓冲区生命周期 #

• 确保所有路径下调用Image.close()：无论是处理完成的图像，还是被舍弃的图像，都必须调用这个方法释放缓冲区。比如在判断无法处理图像时，立即关闭原始Image；克隆像素数据完成后，立刻关闭原始Image，不要持有它等待处理。
• 及时释放克隆后的资源：比如OpenCV的Mat对象处理完成后，要调用release()释放内存。

示例代码片段：

// Camera回调中处理图像
@Override
public void onImageAvailable(ImageReader reader) {
    Image image = reader.acquireNextImage();
    if (image == null) {
        return;
    }

    // 判断是否可处理图像（当前无运行的处理线程）
    if (canProcessImage()) {
        // 克隆像素数据到OpenCV Mat
        Mat mat = convertImageToMat(image);
        // 立刻关闭原始Image，释放Camera缓冲区
        image.close();
        // 提交到OpenCV处理线程
        submitToOpencvThread(mat);
    } else {
        // 无法处理，直接关闭图像释放缓冲区
        image.close();
    }
}

// OpenCV处理完成后释放Mat
private void submitToOpencvThread(Mat mat) {
    // 执行OpenCV处理逻辑...
    mat.release();
}

2. 优化线程调度与处理效率 #

• 调整OpenCV线程优先级：将线程优先级设为THREAD_PRIORITY_BACKGROUND，避免抢占Camera框架线程的CPU资源：

HandlerThread opencvThread = new HandlerThread("OpenCV-Processing", Process.THREAD_PRIORITY_BACKGROUND);
opencvThread.start();

• 优化OpenCV处理逻辑：对耗时操作进行优化，比如先缩小图像尺寸再处理，或者使用OpenCV的硬件加速接口（如果设备支持）；
• 用任务队列缓存处理数据：缓存克隆后的像素数据（而非原始Image对象），避免持有缓冲区资源等待处理。

3. 匹配捕获帧率与处理能力 #

• 限制捕获帧率：通过CaptureRequest.CONTROL_AE_TARGET_FPS_RANGE设置帧率范围，确保不超过你的处理速度：

Range<Integer> fpsRange = new Range<>(10, 15); // 限制为10-15帧/秒
captureRequestBuilder.set(CaptureRequest.CONTROL_AE_TARGET_FPS_RANGE, fpsRange);

• 改用capture()替代setRepeatingRequest：如果是批量拍照场景，处理完一张图像后再发送下一个捕获请求，避免请求队列积压，更精准控制缓冲区使用。

另外，Android 6.0的Camera2 API存在部分兼容性问题，你可以检查设备的Camera2支持级别（通过CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL），如果是LIMITED级别，建议采用更保守的缓冲区管理策略。

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