Flutter相机屏幕启动时空检查运算符使用错误的排查与修复

原因分析 #

启动时短暂出现的Null check operator used on a null value错误，主要来自两个潜在问题：

1. 设备内存判断中的空断言风险：如果SystemInfoPlus.physicalMemory返回null（部分设备/系统版本不支持该API），尽管代码有判空逻辑，但异步执行的微小时序偏差可能导致deviceMemory为null时仍触发deviceMemory!的空断言。
2. 相机控制器的不安全访问：build方法中_controller != null的判断和_controller!的使用之间，可能因页面初始化的异步流程出现状态不一致，极端情况下导致空断言触发。

修复步骤 #

1. 移除设备内存判断中的空断言 #

将依赖deviceMemory的分辨率判断逻辑改为无断言的安全写法，避免直接使用!：

// 替换startLive中CameraController的分辨率参数
_controller = CameraController(
  camera,
  // 用空合并运算符默认赋值，避免空断言
  (deviceMemory ?? 4096) <= 3072 ? ResolutionPreset.low : ResolutionPreset.high,
  enableAudio: false,
);

这里当deviceMemory为null时，默认按4096MB（大于3072）处理，自动选择高分辨率，完全规避空断言风险。

2. 优化相机控制器的初始化与状态更新 #

将startLive中的异步初始化逻辑改为await形式，确保控制器就绪后再更新状态，避免未初始化的控制器触发build错误：

Future<void> startLive() async {
  // 先判断相机列表是否有效，避免索引越界
  if (cameras.isEmpty || _cameraIndex >= cameras.length) {
    print('相机列表为空或索引无效');
    return;
  }
  final camera = cameras[_cameraIndex];

  _controller = CameraController(
    camera,
    (deviceMemory ?? 4096) <= 3072 ? ResolutionPreset.low : ResolutionPreset.high,
    enableAudio: false,
  );

  try {
    // 等待控制器初始化完成
    await _controller!.initialize();
    if (!mounted) return;
    // 启动图像流
    _controller!.startImageStream(_processCameraImage);
    // 仅在初始化完成后更新状态
    setState(() {});
  } catch (e) {
    print('相机初始化失败: $e');
    // 初始化失败时重置控制器，避免错误状态残留
    _controller = null;
    setState(() {});
  }
}

3. 确保相机列表提前就绪 #

在初始化相机控制器前，先确保cameras列表已完成获取，避免因空列表导致后续错误：

List<CameraDescription> cameras = [];

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    // 先获取相机列表
    cameras = await availableCameras();
    await getDeviceMemory();
    initCameraLens();
    await startLive();
  });
}

4. 简化build方法中的控制器判断 #

将build中的条件渲染改为更直观的形式，避免不必要的空断言：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Stack(
      fit: StackFit.expand,
      children: [
        if (_controller != null) CameraPreview(_controller!),
        if (_controller == null) Container(
          width: 100.w,
          height: 100.h,
          color: Colors.black,
        ),
      ],
    ),
  );
}

总结 #

通过移除空断言、优化异步初始化流程、确保依赖数据就绪这几个步骤，可以彻底解决启动时的短暂Null check错误，同时提升代码的稳定性和可读性。

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