第4章：相机打开失败崩溃——CameraProvider.bindToLifecycle异常、CameraXConfig配置错误、权限未授予

4.1 现象识别

4.2 数据采集

在崩溃发生时，至少收集以下三类数据才能精准定位根因：

1. 崩溃堆栈（必须）：通过 Thread.setDefaultUncaughtExceptionHandler 或 Firebase Crashlytics 捕获完整栈帧。
2. 权限状态日志：在 onStart() 中输出当前权限授予状态。
3. CameraX 初始化配置快照：打印 CameraXConfig 的 provider 是否为空、是否调用了 CameraX.init()。

// 数据采集示例——在 Application.onCreate 中打印配置
CameraXConfig config = CameraXConfig.Builder.fromConfig(
    Camera2Config.defaultConfig())
    .setMinimumLoggingLevel(Log.DEBUG)
    .build();
Log.d("CameraXInit", "config provider = " + config.getCameraFactoryProvider());
// 输出：如果 provider 为 null，则后续 bindToLifecycle 必然失败

4.3 原因定位——故障树分析

以下故障树（Fault Tree）直接映射到崩溃现场，按“是否满足前置条件”逐层排查：

4.4 修复动作

按照“先权限→再配置→后绑定”的顺序实施修复，每步验证后测试。

4.4.1 运行时权限检查修复

// 必须动态请求 CAMERA 权限，且在 onRequestPermissionsResult 中调用 initCamera()
if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.CAMERA}, REQUEST_CAMERA_PERMISSION);
    return; // 不要执行 bindToLifecycle
}
// 权限已授予后初始化
initCamera();

4.4.2 CameraXConfig 注入修复

在 Application.onCreate() 中调用 CameraX.init()，且必须传入非空配置：

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        CameraXConfig config = new CameraXConfig.Builder()
                .setCameraFactoryProvider(Camera2Config.defaultConfig().getCameraFactoryProvider())
                .setDeviceSurfaceManagerProvider(
                    Camera2Config.defaultConfig().getDeviceSurfaceManagerProvider())
                .setMinimumLoggingLevel(Log.WARN)
                .build();
        CameraX.initialize(this, config);
    }
}

4.4.3 bindToLifecycle 安全调用修复

// 确保在 Lifecycle 至少为 STARTED 状态时绑定
if (lifecycle.getCurrentState().isAtLeast(Lifecycle.State.STARTED)) {
    processCameraProvider.bindToLifecycle(
            lifecycleOwner,
            cameraSelector,
            preview,
            imageCapture,
            imageAnalysis
    );
} else {
    Log.w("CameraBind", "Lifecycle 未达到 STARTED，延迟绑定");
    // 建议在 onStart 中处理，而不是立即抛异常
}

4.5 复测方案

4.6 预防体系

• 编译期检查：使用 lint 规则 MissingPermission 强制所有调用 bindToLifecycle 的代码路径必须有权限守卫。
• 配置模板标准化：统一使用 CameraXConfigProvider 接口，避免在多个地方手动创建配置。
• 生命周期自动绑定辅助类：封装 CameraXLifecycleObserver，当收到 ON_START 事件时再执行绑定。
• 监控告警：在崩溃平台中为 CameraInfoUnavailableException 设置单独告警，阈值 >0.1% 触发 P0 工单。

// 预防配置模板——推荐在 Application 中注册自定义 CameraXConfigProvider
public class CameraXConfigProviderImpl implements CameraXConfig.Provider {
    @NonNull
    @Override
    public CameraXConfig getCameraXConfig() {
        return CameraXConfig.Builder.fromConfig(Camera2Config.defaultConfig())
                .setMinimumLoggingLevel(Log.ERROR)
                .setAvailableCamerasLimiter(CameraSelector.DEFAULT_BACK_CAMERA)
                .build();
    }
}
// 在 AndroidManifest.xml 中声明：
// <provider android:name=".CameraXConfigProviderImpl"
//           android:authorities="${applicationId}.cameraxconfig"
//           android:exported="false" />