CameraX报错Unable to configure camera 0超时 预览黑屏如何解决

• bindToLifecycle传入的生命周期所有者参数错误：代码中直接将requireContext()强转为LifecycleOwner传入，一方面普通Context实例本身未实现LifecycleOwner接口，强转逻辑存在运行时类型不匹配风险；另一方面如果代码写在Fragment中，传入Context/Activity实例会导致相机生命周期和Fragment视图生命周期不同步，相机初始化流程无法正确绑定生命周期状态，直接触发配置超时。
• 缺少运行时相机权限申请逻辑：仅在Manifest中声明相机权限不足以在Android 6.0及以上系统获取相机访问权，相机权限属于危险权限，必须在运行时主动向用户申请并拿到授权后，才能调用相机能力，未授权状态下相机服务会拒绝访问请求，最终触发配置超时、预览黑屏。
• 视频输出配置兼容性不足：直接给Recorder硬编码Quality.HIGHEST画质，部分设备无法同时支持最高分辨率的视频录制流+预览流输出，相机服务在匹配输出流配置时找不到兼容方案，会卡在初始化流程触发超时。
• 额外可能的诱因：调用相机初始化逻辑时PreviewView还未完成布局测量，宽高为0，导致SurfaceProvider无法提供有效的渲染Surface，相机配置流程一直等待有效Surface触发超时。

1. 补全运行时权限校验逻辑
   在执行相机初始化代码前，先检查相机、录音权限是否已授予，未授予则先发起申请，拿到授权后再启动相机流程：

// 权限校验
if (ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.CAMERA)
        != PackageManager.PERMISSION_GRANTED
    || ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.RECORD_AUDIO)
        != PackageManager.PERMISSION_GRANTED) {
    // 发起权限申请，在权限申请回调中确认用户授权后再调用startCamera方法
    requestPermissions(new String[]{Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO}, 10001);
    return;
}
// 权限校验通过后再初始化相机
startCamera();

2. 修正生命周期绑定参数

• 如果代码写在Fragment中，将bindToLifecycle的第一个参数替换为getViewLifecycleOwner()，保证相机生命周期和Fragment视图生命周期完全同步：

cameraProvider.bindToLifecycle(
        getViewLifecycleOwner(),
        cameraSelector,
        preview,
        mVideoCapture);

• 如果代码写在Activity中，直接传入当前Activity实例（如MainActivity.this）作为第一个参数即可，不要用Application类Context强转。

3. 优化视频质量配置，增加兼容性降级策略
   给QualitySelector增加降级规则，当设备不支持指定最高画质时，自动向下匹配设备支持的可用分辨率，避免流配置失败：

Recorder recorder = new Recorder.Builder()
        .setQualitySelector(
                QualitySelector.from(
                        Quality.HIGHEST,
                        // 配置降级策略：不支持最高画质时，优先匹配接近1080P的可用分辨率
                        FallbackStrategy.higherQualityOrLowerThan(Quality.FHD)
                )
        ).build();
mVideoCapture = VideoCapture.withOutput(recorder);

4. 调整相机初始化时机
   不要在Fragment的onCreate/Activity的onCreate中直接调用相机初始化，改为在PreviewView完成布局后再启动：可以把初始化逻辑放在onResume中，或者给PreviewView添加布局完成监听，确保View已经完成测量、宽高有效时再设置SurfaceProvider、绑定相机用例。

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