CameraX 崩溃全景图：常见崩溃类型、统计维度与优先级分级

1.1 崩溃现象识别：从故障树看崩溃根系

CameraX 作为 Jetpack 相机库，其崩溃谱系并非随机爆发，而是沿着“应用层调用 ➔ 框架生命周期 ➔ 相机硬件抽象层(CAM)” 三层路径向下传导。下面这张故障树将常见崩溃归结为 4 大类 16 种根因，后续所有排查都从这个分类入口出发。

1.2 统计维度：数据采集与崩溃率建模

要量化稳定性水平，必须建立统一的崩溃统计维度。以下四个核心维度既是数据采集点，也是后续排查的过滤条件。

1.3 优先级分级：判断规则与快速决策

依据崩溃率（CR）与影响范围（IR）将优先级分为 P0 ~ P3 四级，每组对应不同的修复动作与曝光时间。

1.4 排查表：崩溃类型快速定位

当你不明确当前崩溃属于哪一类时，按以下排查表从日志中提取关键特征，可快速锁定分类。

1.5 典型日志分析：一次 P0 崩溃的解剖

以下是一段真实项目中复现的 P0 致命崩溃 日志，通过堆栈可以直接定位到初始化阶段。

FATAL EXCEPTION: main
Process: com.example.cameraxdemo, PID: 12345
java.lang.RuntimeException: Unable to start activity ComponentInfo{...MainActivity}:
    java.lang.IllegalStateException: CameraX is not configured properly.
    The CameraXConfig must be set before any CameraX operations.
    at androidx.camera.core.CameraX.checkInitialized(CameraX.java:184)
    at androidx.camera.core.ProcessCameraProvider.getInstance(ProcessCameraProvider.java:89)
    ... 10 more
Caused by: java.lang.IllegalStateException:
    CameraXConfig ApplicationProvider not found.
    Did you add a <provider> for CameraX in AndroidManifest.xml?
    at androidx.camera.core.internal.CameraXConfigProvider...load(CameraXConfigProvider.java:44)
    ... 5 more

<provider
    android:name="androidx.camera.core.impl.CameraXConfigProvider"
    android:authorities="${applicationId}.cameraxconfigprovider"
    android:exported="false"
    android:initOrder="100" />

补全后重新编译，该类崩溃清零。后续第 6 章会详细讲解初始化阶段的 6 种配置防御。

1.6 预防：配置级防御规则

在编写 CameraX 代码前，先落实以下 4 条预防规则，可以在编码阶段过滤掉约 40% 的常见崩溃。

• 规则 1：始终在 Application.onCreate() 中设置 CameraXConfig，避免异步竞争。
• 规则 2：绑定 UseCase 前检查 ProcessCameraProvider 是否可用，捕获 CameraInfoUnavailableException。
• 规则 3：为 ImageAnalysis 设置 setBackpressureStrategy(STRATEGY_KEEP_ONLY_LATEST)，防止背压导致 OOM。
• 规则 4：使用 CameraController 时，确保对应的 LifecycleOwner 已经 onStart，避免提前 bind。